如何使用QDBusAbstractAdaptor派生类发射org.freedesktop.DBus.Properties.PropertiesChanged信号

先解决重复接口错误 #

你遇到的Invalid introspection data: duplicate method 'Get'错误，是因为Qt的QDBusAbstractAdaptor已经默认实现了org.freedesktop.DBus.Properties接口的核心方法（Get/Set/GetAll等），不需要你在服务XML里手动添加这个接口定义。直接去掉XML中关于org.freedesktop.DBus.Properties的接口声明，就能解决重复方法的问题。

手动发射PropertiesChanged信号的两种实现方式 #

Qt不会自动将Q_PROPERTY的NOTIFY信号转为DBus标准的PropertiesChanged信号，需要你在属性更新时手动触发，以下是两种可行方案：

方案1：在适配器类中声明并发射信号 #

首先，确保你的适配器类中正确声明PropertiesChanged信号（匹配DBus标准签名）：

class MyAdaptor : public QDBusAbstractAdaptor
{
    Q_OBJECT
    Q_CLASSINFO("D-Bus Interface", "com.your.CustomInterface") // 你的自定义接口名
    Q_PROPERTY(QString myProperty READ myProperty WRITE setMyProperty NOTIFY myPropertyChanged)

signals:
    // 声明DBus标准的PropertiesChanged信号
    void PropertiesChanged(const QString &interfaceName, const QVariantMap &changedProperties, const QStringList &invalidatedProperties);

public:
    explicit MyAdaptor(QObject *parent = nullptr);
    QString myProperty() const;
    void setMyProperty(const QString &newValue);

private:
    QString m_myProperty;
};

然后在属性的setter方法中触发信号：

void MyAdaptor::setMyProperty(const QString &newValue)
{
    if (m_myProperty == newValue) return;

    m_myProperty = newValue;
    emit myPropertyChanged(newValue); // 触发Q_PROPERTY的NOTIFY信号

    // 构造变化的属性映射，发射DBus信号
    QVariantMap changedProps;
    changedProps.insert("myProperty", QVariant::fromValue(newValue));
    emit PropertiesChanged("com.your.CustomInterface", changedProps, QStringList());
}

方案2：直接构造DBus消息发送 #

如果不想在适配器类中额外声明信号，可以直接构造QDBusMessage发送信号，无需修改适配器类的信号声明：

void MyAdaptor::setMyProperty(const QString &newValue)
{
    if (m_myProperty == newValue) return;

    m_myProperty = newValue;
    emit myPropertyChanged(newValue);

    // 构造PropertiesChanged信号消息
    QDBusMessage signalMsg = QDBusMessage::createSignal(
        "/com/your/ObjectPath", // 你的服务对象路径
        "org.freedesktop.DBus.Properties", // 标准属性接口名
        "PropertiesChanged" // 信号名
    );

    // 填充信号参数：接口名、变化的属性、无效属性列表
    QVariantMap changedProps;
    changedProps.insert("myProperty", QVariant::fromValue(newValue));
    signalMsg << "com.your.CustomInterface";
    signalMsg << changedProps;
    signalMsg << QStringList();

    // 发送到会话总线
    QDBusConnection::sessionBus().send(signalMsg);
}

关键注意事项 #

• 确保Q_PROPERTY的WRITE方法中做了值判断，避免重复发射信号。
• 信号中的interfaceName参数必须是你的自定义接口名（即Q_CLASSINFO中指定的接口），不是org.freedesktop.DBus.Properties。
• 无效属性列表（第三个参数）用于标记哪些属性变得不可用，一般为空即可。

内容的提问来源于stack exchange，提问作者Thilo Cestonaro