尧图网站建设 
5分钟快速上手zbus建立D-Bus连接并发起第一次方法调用【免费下载链接】zbusRust D-Bus crate.项目地址: https://gitcode.com/gh_mirrors/zb/zbuszbus 是专注于 D-Bus 协议的 Rust 库本文带你从零开始用 zbus 快速建立 D-Bus 会话总线连接并发起第一次 D-Bus 方法调用——只需三步5 分钟即可跑通适合刚接触 Linux 进程间通信IPC的新手。 先花30秒认识 zbusD-Bus 是 Linux 上事实标准的进程间通信方案systemd、NetworkManager 以及 GNOME/KDE 桌面环境都依赖它。而zbus以 100% Rust 原生方式实现了 D-Bus 协议帮你搞定连接建立、方法调用、信号收发、属性读写这些繁琐细节。项目核心由几个 crate 组成Crate一句话作用zbus主 API连接、方法调用、信号、属性zvariantD-Bus 数据类型的序列化/反序列化兼容 serdezbus_xmlgen从 D-Bus 内省 XML 生成 Rust trait 样板代码的命令行工具开始之前请确保系统已安装 D-Bus 守护进程主流 Linux 发行版默认自带。1️⃣ 添加 zbus 依赖在你的 Rust 项目Cargo.toml中加入[dependencies] zbus 5 tokio { version 1, features [rt-multi-thread, macros] }zbus 默认启用了async-io和blocking-api特性见 zbus/Cargo.toml。你可以自由选择异步运行时如果不想碰 async/await还可以直接使用阻塞式 API两种方式都很快上手。2️⃣ 建立 D-Bus 连接D-Bus 有两条总线会话总线session bus每个用户一套桌面程序之间通信用它系统总线system bus系统级服务如 systemd、NetworkManager用它。zbus 提供两个一行式 APIuse zbus::Connection; let conn Connection::session().await?; // 连接会话总线 let conn Connection::system().await?; // 连接系统总线不想用异步运行时阻塞版同样简单use zbus::blocking::Connection; let conn Connection::session().unwrap();连接建立后zbus 会自动完成认证与 Hello 握手流程实现见 zbus/src/connection/handshake/mod.rs你完全不用关心协议细节。3️⃣ 发起第一次方法调用最核心的操作是方法调用。Connection的call_method()直接可用参数依次为目标服务名、对象路径、接口名、方法名、方法参数。zbus 会自动生成 D-Bus 类型签名省去手写签名的麻烦。以官方教程书中的经典例子为例——调用桌面通知服务弹一条通知完整章节见 book/src/client.mduse zbus::{zvariant::Value, Connection}; #[tokio::main] async fn main() - zbus::Result() { let conn Connection::session().await?; let m conn.call_method( Some(org.freedesktop.Notifications), // 目标服务 /org/freedesktop/Notifications, // 对象路径 Some(org.freedesktop.Notifications), // 接口名 Notify, // 方法名 (my-app, 0u32, dialog-information, 你好 zbus, 这是第一次 D-Bus 方法调用, vec![; 0], std::collections::HashMap::str, Value::new(), 5000), ).await?; let notification_id: u32 m.body().deserialize()?; println!(通知 ID: {notification_id}); Ok(()) }如果你的机器没有图形桌面可以改调其他始终可用的服务项目里就有一个实用范例——用 D-Bus 调整 GNOME 屏幕亮度见 zbus/examples/screen-brightness.rs。官方测试套件里也保留了最基础的连接 方法调用用例可参考 zbus/tests/basic.rs。更地道的写法trait #[proxy] 宏低层call_method灵活但容易写错参数顺序、0与0u32之类的类型笔误编译器无法发现。zbus 的招牌能力是#[proxy]宏把 D-Bus 接口声明成 Rust trait宏会自动生成带类型安全封装的TProxy类型宏源码在 zbus_macros/src/proxy.rsuse zbus::proxy; #[proxy( default_service org.freedesktop.Notifications, default_path /org/freedesktop/Notifications )] trait Notifications { fn notify( self, app_name: str, replaces_id: u32, app_icon: str, summary: str, body: str, actions: [str], hints: std::collections::HashMapstr, zvariant::Value_, expire_timeout: i32, ) - zbus::Resultu32; } // 调用就变得像普通 Rust 方法一样自然 let proxy NotificationsProxy::new(conn).await?; let id proxy.notify(my-app, 0, dialog-information, 你好 zbus, 第一次方法调用, [], std::collections::HashMap::new(), 5000) .await?;同一套 trait 写法还支持信号订阅与属性读取#[zbus(signal)]、#[zbus(property)]教程书有完整讲解见 book/src/client.md。如果已有现成服务的内省 XML还能用zbus-xmlgen命令直接生成上面的 trait 样板代码一行手写都不用。 新手常见问题速查遇到问题解决办法macOS 上连不上会话总线需启用 Launchd 兼容特性并正确安装 dbus说明见 book/src/connection.md阻塞 API 放进 async 上下文挂死阻塞 API 不要在 async/await 里使用改用异步Connection方法参数类型总写错改用#[proxy]trait 形式让编译器帮你把关想连接自定义地址的总线用connection::Builder::address()指定 D-Bus 地址✅ 小结你现在已经掌握了 zbus 的三步核心流程在Cargo.toml中加入zbus依赖用Connection::session()/Connection::system()建立 D-Bus 连接用call_method()发起第一次方法调用再用#[proxy]升级为类型安全的代理。项目自带的教程书目录见 book/src/SUMMARY.md建议按「概念 → 连接 → 客户端代理 → 阻塞 API」的顺序继续深入配合 book/src/concepts.md 理解接口、信号与属性的含义就能快速写出生产级 D-Bus 程序了。【免费下载链接】zbusRust D-Bus crate.项目地址: https://gitcode.com/gh_mirrors/zb/zbus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 5分钟快速上手zbus：建立D-Bus连接并发起第一次方法调用
5分钟快速上手zbus建立D-Bus连接并发起第一次方法调用【免费下载链接】zbusRust D-Bus crate.项目地址: https://gitcode.com/gh_mirrors/zb/zbuszbus 是专注于 D-Bus 协议的 Rust 库本文带你从零开始用 zbus 快速建立 D-Bus 会话总线连接并发起第一次 D-Bus 方法调用——只需三步5 分钟即可跑通适合刚接触 Linux 进程间通信IPC的新手。 先花30秒认识 zbusD-Bus 是 Linux 上事实标准的进程间通信方案systemd、NetworkManager 以及 GNOME/KDE 桌面环境都依赖它。而zbus以 100% Rust 原生方式实现了 D-Bus 协议帮你搞定连接建立、方法调用、信号收发、属性读写这些繁琐细节。项目核心由几个 crate 组成Crate一句话作用zbus主 API连接、方法调用、信号、属性zvariantD-Bus 数据类型的序列化/反序列化兼容 serdezbus_xmlgen从 D-Bus 内省 XML 生成 Rust trait 样板代码的命令行工具开始之前请确保系统已安装 D-Bus 守护进程主流 Linux 发行版默认自带。1️⃣ 添加 zbus 依赖在你的 Rust 项目Cargo.toml中加入[dependencies] zbus 5 tokio { version 1, features [rt-multi-thread, macros] }zbus 默认启用了async-io和blocking-api特性见 zbus/Cargo.toml。你可以自由选择异步运行时如果不想碰 async/await还可以直接使用阻塞式 API两种方式都很快上手。2️⃣ 建立 D-Bus 连接D-Bus 有两条总线会话总线session bus每个用户一套桌面程序之间通信用它系统总线system bus系统级服务如 systemd、NetworkManager用它。zbus 提供两个一行式 APIuse zbus::Connection; let conn Connection::session().await?; // 连接会话总线 let conn Connection::system().await?; // 连接系统总线不想用异步运行时阻塞版同样简单use zbus::blocking::Connection; let conn Connection::session().unwrap();连接建立后zbus 会自动完成认证与 Hello 握手流程实现见 zbus/src/connection/handshake/mod.rs你完全不用关心协议细节。3️⃣ 发起第一次方法调用最核心的操作是方法调用。Connection的call_method()直接可用参数依次为目标服务名、对象路径、接口名、方法名、方法参数。zbus 会自动生成 D-Bus 类型签名省去手写签名的麻烦。以官方教程书中的经典例子为例——调用桌面通知服务弹一条通知完整章节见 book/src/client.mduse zbus::{zvariant::Value, Connection}; #[tokio::main] async fn main() - zbus::Result() { let conn Connection::session().await?; let m conn.call_method( Some(org.freedesktop.Notifications), // 目标服务 /org/freedesktop/Notifications, // 对象路径 Some(org.freedesktop.Notifications), // 接口名 Notify, // 方法名 (my-app, 0u32, dialog-information, 你好 zbus, 这是第一次 D-Bus 方法调用, vec![; 0], std::collections::HashMap::str, Value::new(), 5000), ).await?; let notification_id: u32 m.body().deserialize()?; println!(通知 ID: {notification_id}); Ok(()) }如果你的机器没有图形桌面可以改调其他始终可用的服务项目里就有一个实用范例——用 D-Bus 调整 GNOME 屏幕亮度见 zbus/examples/screen-brightness.rs。官方测试套件里也保留了最基础的连接 方法调用用例可参考 zbus/tests/basic.rs。更地道的写法trait #[proxy] 宏低层call_method灵活但容易写错参数顺序、0与0u32之类的类型笔误编译器无法发现。zbus 的招牌能力是#[proxy]宏把 D-Bus 接口声明成 Rust trait宏会自动生成带类型安全封装的TProxy类型宏源码在 zbus_macros/src/proxy.rsuse zbus::proxy; #[proxy( default_service org.freedesktop.Notifications, default_path /org/freedesktop/Notifications )] trait Notifications { fn notify( self, app_name: str, replaces_id: u32, app_icon: str, summary: str, body: str, actions: [str], hints: std::collections::HashMapstr, zvariant::Value_, expire_timeout: i32, ) - zbus::Resultu32; } // 调用就变得像普通 Rust 方法一样自然 let proxy NotificationsProxy::new(conn).await?; let id proxy.notify(my-app, 0, dialog-information, 你好 zbus, 第一次方法调用, [], std::collections::HashMap::new(), 5000) .await?;同一套 trait 写法还支持信号订阅与属性读取#[zbus(signal)]、#[zbus(property)]教程书有完整讲解见 book/src/client.md。如果已有现成服务的内省 XML还能用zbus-xmlgen命令直接生成上面的 trait 样板代码一行手写都不用。 新手常见问题速查遇到问题解决办法macOS 上连不上会话总线需启用 Launchd 兼容特性并正确安装 dbus说明见 book/src/connection.md阻塞 API 放进 async 上下文挂死阻塞 API 不要在 async/await 里使用改用异步Connection方法参数类型总写错改用#[proxy]trait 形式让编译器帮你把关想连接自定义地址的总线用connection::Builder::address()指定 D-Bus 地址✅ 小结你现在已经掌握了 zbus 的三步核心流程在Cargo.toml中加入zbus依赖用Connection::session()/Connection::system()建立 D-Bus 连接用call_method()发起第一次方法调用再用#[proxy]升级为类型安全的代理。项目自带的教程书目录见 book/src/SUMMARY.md建议按「概念 → 连接 → 客户端代理 → 阻塞 API」的顺序继续深入配合 book/src/concepts.md 理解接口、信号与属性的含义就能快速写出生产级 D-Bus 程序了。【免费下载链接】zbusRust D-Bus crate.项目地址: https://gitcode.com/gh_mirrors/zb/zbus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考