使用gdbus-codegen时如何查看struct _MinMinBusGDBUS的实现

#define MIN_MIN_BUS_TYPE_GDBUS (min_min_bus_gdbus_get_type ())
#define MIN_MIN_BUS_GDBUS(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), MIN_MIN_BUS_TYPE_GDBUS, MinMinBusGDBUS))
#define MIN_MIN_BUS_IS_GDBUS(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), MIN_MIN_BUS_TYPE_GDBUS))
#define MIN_MIN_BUS_GDBUS_GET_IFACE(o) (G_TYPE_INSTANCE_GET_INTERFACE ((o), MIN_MIN_BUS_TYPE_GDBUS, MinMinBusGDBUSIface))

struct _MinMinBusGDBUS;
typedef struct _MinMinBusGDBUS MinMinBusGDBUS;
typedef struct _MinMinBusGDBUSIface MinMinBusGDBUSIface;

这不是代码缺失或者漏找文件，是GObject接口类型的标准设计规范，这个结构体从设计上就不需要公开完整定义，甚至本身不需要编写实际的成员实现：

• 代码中的G_TYPE_INSTANCE_GET_INTERFACE宏已经明确标识MinMinBusGDBUS是GObject接口类型，不是可以直接实例化的普通对象类
• 按照GObject类型系统的规则，接口类型的实例结构体（即这里的struct _MinMinBusGDBUS）只需要做前置声明，不需要定义具体成员——它的作用仅仅是给类型系统提供唯一的类型标记，接口本身不能直接创建实例，只能被其他具体的GObject类实现
• 该接口的方法表、信号、属性定义全部存放在对应的MinMinBusGDBUSIface结构体中，在同仓库的其他源码文件中可以找到这个Iface结构体的完整定义
• 所有对MinMinBusGDBUS类型的操作都必须通过接口暴露的公开方法完成，不允许直接访问实例结构体成员，这是GObject封装特性的强制要求。

不要一开始就啃底层API或者全量规范，按照以下阶段学习效率最高：

• 第一阶段：补GObject核心基础
  不需要啃完GObject的全部文档，先掌握核心概念即可：类/实例结构体的作用、类型注册宏的逻辑、继承规则、接口实现方式、属性、信号。能看懂普通GObject类的头文件定义、能写出最简单的继承自GObject的类就算达标，重点搞懂G_TYPE_CHECK_INSTANCE_CAST这类常用宏的作用，否则看GDBus代码会被大量宏绕晕。
• 第二阶段：掌握D-Bus基础概念
  不用上来就啃全量D-Bus规格，先搞懂几个核心点即可：总线分类（系统总线/会话总线）、对象路径、接口名、方法调用与返回、信号广播、属性读写、唯一/熟知总线名的区别，明确D-Bus是用于进程间通信的消息总线，了解单条消息的基本结构。
• 第三阶段：用高层API跑通最小Demo
  不要一开始就碰GDBusConnection、GDBusMessage这类底层API，优先用最高层的工具链上手：
  • 先学会使用gdbus-codegen工具，通过D-Bus的XML接口定义自动生成C语言的服务端桩代码和客户端代理代码，你看到的minminbus相关代码本质就是这类自动生成的接口代码
  • 先写服务端：用自动生成的桩代码实现接口方法，把GObject对象注册到总线上
  • 再写客户端：用自动生成的代理连接总线，完成调用服务端方法、监听服务端信号、读写服务端属性的操作
    跑通两个独立进程通过D-Bus完成一次方法调用的最小Demo就算达标。
• 第四阶段：按需学习中低层API
  高层API用熟之后，再根据实际场景补对应的中低层能力：如果需要不预生成代码做动态代理，就学GDBusProxy的手动实现；如果需要动态处理任意接口的请求，就学GDBusNodeInfo和手动注册对象的接口；如果需要自定义消息流，再看GDBusConnection的底层消息收发接口。

常见避坑点 #

• 不要手写GDBus接口的类型注册、结构体定义代码，90%的业务场景下gdbus-codegen生成的代码已经足够，手写很容易出现类型注册偏移、宏定义错误的问题
• GDBus所有异步方法的回调都在所属线程的主循环中触发，没有启动主循环永远收不到异步回调
• D-Bus对接口名、对象路径、总线名的命名有强制规范，不符合规范的名称会直接导致注册失败，没有兼容余地

内容的提问来源于stack exchange，提问作者kim hyeunggi