Changes to Qt Remote Objects
Qt 6 is a result of the conscious effort to make the framework more efficient and easy to use.
We try to maintain binary and source compatibility for all the public APIs in each release. But some changes were inevitable in an effort to make Qt a better framework.
In this topic we summarize those changes in Qt Remote Objects, and provide guidance to handle them.
API changes
Functions taking const-ref QString changing to QStringView
QRemoteObjectHostBase::proxy, QRemoteObjectHostBase::reverseProxy and QRemoteObjectNode::instances now accept a QStringView instead of const QString &
. The largest difference caused by this is that it no longer accepts implicit conversion from string literals (i.e. node.instances("abc");
). Instead, you could use a UTF-16 string literal (node.instances(u"abc")
).
Changes to classes for custom transport backend support
The "semi-private" IoDeviceBase
, ServerIoDevice
, and ClientIoDevice
classes are now renamed to QtROIoDeviceBase
, QtROServerIoDevice
, and QtROClientIoDevice
respectively, to be consistent with naming in Qt. They are also moved from the private qconnectionfactories_p.h
header to qconnectionfactories.h
.
Note: These classes are provided to give more flexibility for implementing custom communication protocols for Qt Remote Objects, but there are no source or binary compatibility guarantees for them. We recommend using the QRemoteObjectNode::addClientSideConnection() and QRemoteObjectHostBase::addHostSideConnection() methods, if you need support for external communication channels.
CMake changes
The cmake
instructions for calling repc and adding the generated .rep
files to a CMake project have slightly changed. Instead of the qt5_generate_repc
macro, you should now use qt6_add_repc_sources
, qt6_add_repc_replicas
and qt6_add_repc_merged
functions. For example, the following code:
set(SOURCES main.cpp simpleswitch.cpp ) qt5_generate_repc(SOURCES simpleswitch.rep SOURCE) add_executable(directconnectserver ${SOURCES})
Should change to:
set(SOURCES main.cpp simpleswitch.cpp ) add_executable(directconnectserver ${SOURCES}) qt6_add_repc_sources(directconnectserver simpleswitch.rep)
More detailed descriptions for these CMake functions can be found here.
© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.