Changes to Qt Remote Objects#
Migrate Qt Remote Objects to Qt 6.
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#
proxy
, reverseProxy
and 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 addClientSideConnection()
and 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 .