第2章 Dagger基础组件详解：@Module、@Provides、@Component、@Inject

2.1 四个注解的角色定位

2.2 @Inject — 依赖注入的起点

@Inject 是 Dagger 识别依赖关系的最直接方式。当它标注在构造函数上时，Dagger 会将该类视为可自动提供的实例；当标注在字段上时，表示该字段需要被注入。

// 可注入构造 — Dagger 可直接创建 KeyguardSecurityContainerController
public class KeyguardSecurityContainerController {
    @Inject
    public KeyguardSecurityContainerController(
            KeyguardSecurityModel securityModel,
            KeyguardUpdateMonitor updateMonitor) {
        // 参数将自动从组件图中获取
    }
}

// 字段注入 — 在 Activity 或 Fragment 中声明
public class KeyguardHostView extends FrameLayout {
    @Inject
    KeyguardSecurityContainerController controller;

    @Override
    protected void onFinishInflate() {
        // 需要先调用 component.inject(this)
    }
}

2.3 @Module + @Provides — 外部依赖的适配器

当依赖的构造函数无法标注 @Inject（如第三方库、系统服务、Builder 模式）时，通过 @Module 封装提供方法，并用 @Provides 标注。每个 @Provides 方法就是一条依赖提供声明。

@Module
public class SystemServicesModule {
    @Provides
    @Singleton
    public PowerManager providePowerManager(Context context) {
        // PowerManager 是系统服务，无法在构造上加 @Inject
        return (PowerManager) context.getSystemService(Context.POWER_SERVICE);
    }

    @Provides
    public NotificationManager provideNotificationManager(Context context) {
        return (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
    }
}

2.4 @Component — 注入桥接器

@Component 注解的接口定义了 Dagger 生成的注入器入口。它声明了三个关键信息：注入目标（哪些类需要注入）、依赖来源（依赖哪些 Module）、作用域（是否全局单例）。

@Singleton
@Component(modules = {
    SystemServicesModule.class,
    KeyguardModule.class,
    NotificationModule.class
})
public interface SystemUIComponent {
    // 定义 inject 方法，每个需要字段注入的类提供一个重载
    void inject(KeyguardHostView keyguardHostView);
    void inject(NotificationPanelView notificationPanel);

    // 暴露依赖给子组件
    KeyguardSecurityModel keyguardSecurityModel();
}

2.5 四个注解的协作流程

为便于直观理解四个注解如何组合成完整注入链路，请参考下方的依赖注入组件协作图。

2.6 调试与验证技巧

• 编译时校验：Dagger 在编译期生成 DaggerXXXComponent 类，若某个依赖无法解析，编译直接报错并提示缺失的 Binding。
• 依赖图导出：在 build.gradle 中添加参数 -Adagger.fullGraphDebug，可在 build/generated/source/apt/debug/ 中看到依赖图文本文件。
• 重复绑定错误：如果 @Module 与 @Inject 构造同时提供了同一类型，Dagger 会报 DuplicateBindings 错误。优先保留 @Module 提供的方法，移除 @Inject 构造上的标注。

2.7 性能与稳定性优化建议