W3cubDocs

/Qt

qt_add_dbus_interface

Generates C++ sources implementing an interface for a D-Bus interface description file.

The command is defined in the DBus component of the Qt6 package. Load the package with:

find_package(Qt6 COMPONENTS DBus REQUIRED)

Synopsis

qt_add_dbus_interface(<VAR> dbus_spec basename)

If versionless commands are disabled, use qt6_add_dbus_interface() instead. It supports the same set of arguments as this command.

Description

Generates C++ sources implementing an interface for a D-Bus interface description file defined in dbus_spec. The generated files are named after basename: basename.h, basename.cpp, basename.moc. The paths of the files are added to <VAR>.

The function sets up a call to the Qt D-Bus XML compiler (qdbusxml2cpp) in interface (proxy) mode. By default, qdbusxml2cpp generates a C++ class named after the interface name, with a namespaced alias:

D-Bus Interface Name Class name Namespaced name
org.example.chat OrgExampleChatInterface org.example.chat

Options

Options can be set using set_source_file_property on the dbus_spec:

Option Value Description
CLASSNAME class_name Override the default interface class name with class_name.
NO_NAMESPACE boolean Do not generate the namespaced name if set to ON.
INCLUDE path Add an #include "path" in the generated code.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qtdbus-cmake-qt-add-dbus-interface.html