Dagger Reflect full reflection模式配置与代码改造

Dagger Reflect full reflection模式配置与代码改造

【免费下载链接】dagger-reflectA reflection-based implementation of the Dagger dependency injection library for fast IDE builds.项目地址: https://gitcode.com/gh_mirrors/da/dagger-reflect

Dagger Reflect 是一个基于反射机制实现 Dagger 依赖注入的轻量库，它的核心价值在于消除注解处理器带来的编译开销，让 IDE 构建和单元测试显著提速。本文将完整讲解 Dagger Reflect full reflection 模式的配置步骤，并手把手带你完成现有 Dagger 代码的改造迁移，帮助你在不改变依赖注入语义的前提下，享受"零注解处理器"带来的极速构建体验。

为什么需要 Dagger Reflect？—— 编译加速的痛点

用过 Dagger 的同学都有体会：每改一行代码，DaggerMyComponent这类生成代码都要重新跑一遍注解处理器，项目越大，编译等待时间越长，IDE 的反馈也越迟钝。

Dagger Reflect 正是为了解决这一痛点而生的开源方案：它用反射（Reflection）在运行时动态解析组件、模块与绑定关系，把编译期的工作量降到最低。项目描述中明确写道，它是 "A reflection-based implementation of the Dagger dependency injection library for fast IDE builds"，即面向快速 IDE 构建的 Dagger 反射实现。

通俗地说：Dagger 走"编译期生成代码"路线，Dagger Reflect 走"运行时反射解析"路线，两条路都能完成依赖注入，但后者的构建速度更快。

两种集成模式：Partial Reflection 与 Full Reflection

Dagger Reflect 提供了两种接入方式，理解了它们的区别，你才能选对改造策略。

本文的主角是full reflection 模式：它彻底绕开所有注解处理器，只保留运行时反射库，换来最快的增量构建体验。

Dagger Reflect full reflection 模式配置步骤

第一步：在 Gradle 中配置依赖

以 Android 项目为例，在build.gradle中添加如下配置（当前版本为 0.3.0，详见 CHANGELOG.md）：

dependencies { if (properties.containsKey('android.injected.invoked.from.ide')) { debugApi 'com.jakewharton.dagger:dagger-reflect:0.3.0' // 或 debugImplementation } else { debugAnnotationProcessor "com.google.dagger:dagger-compiler:$daggerVersion" debugApi 'com.jakewharton.dagger:dagger-codegen:0.3.0' // 或 debugImplementation } releaseAnnotationProcessor "com.google.dagger:dagger-compiler:$daggerVersion" releaseApi 'com.jakewharton.dagger:dagger-codegen:0.3.0' // 或 releaseImplementation api "com.google.dagger:dagger:$daggerVersion" // 或 implementation }

第二步：理解android.injected.invoked.from.ide开关

这段配置的精妙之处在于android.injected.invoked.from.ide这个属性：

• 在 IDE 中运行时，该属性存在，走dagger-reflect反射库 → 构建最快；
• 命令行/CI 完整构建时，走标准 Dagger 编译器，保证发布包质量。

也就是说，只有开发调试阶段享受反射加速，发布构建仍然使用稳定可靠的官方 Dagger，兼顾了开发效率与生产安全。这也是本项目的官方推荐用法，完整示例可参考 README.md。

Dagger 代码改造：三处核心替换

配置好依赖后，接下来就是把代码中调用"生成类"的地方，统一改为调用静态Dagger工厂方法。核心就三个场景：

1. 组件创建：create 改造

- MyComponent component = DaggerMyComponent.create(); + MyComponent component = Dagger.create(MyComponent.class);

2. 工厂创建：factory 改造

- MyComponent.Factory factory = DaggerMyComponent.factory(); + MyComponent.Factory factory = Dagger.factory(MyComponent.Factory.class);

3. 构建器创建：builder 改造

- MyComponent.Builder builder = DaggerMyComponent.builder(); + MyComponent.Builder builder = Dagger.builder(MyComponent.Builder.class);

改造逻辑非常简单：把"生成的类 + 静态方法"换成"反射库的Dagger类 + 组件 Class 字面量"。

从源码看，reflect/src/main/java/dagger/Dagger.java 中的create/factory/builder三个方法，会统一委托给 DaggerReflect.java，后者再分别交给ComponentInvocationHandler、ComponentFactoryInvocationHandler、ComponentBuilderInvocationHandler处理——它们全部基于 Java 动态代理（Proxy）实现，真正做到了零代码生成。

代码改造后的注意事项与限制

切换 full reflection 模式后，有几点务必留意，否则会踩坑：

⚠️ 组件必须是接口

由于反射运行时依赖 JavaProxy机制，只有接口类型的 Component、Factory、Builder 才能被代理。如果你的组件是抽象类（Abstract Class），将无法使用本方案，需要先重构为接口。

⚠️ 组件需要 public 可见性

当 Factory 或 Builder 需要创建其外层组件实例时，外层组件必须是 public 的，否则代理无法跨包访问。

⚠️ 自定义注解必须声明 RUNTIME 保留策略

反射解析依赖注解的运行时可见性，因此你自定义的@Qualifier、@MapKey等注解必须加上@Retention(RetentionPolicy.RUNTIME)，否则反射阶段读不到它们。

好消息是，项目提供了 reflect-lint 模块来帮你自动检查这一点：其中的WrongRetentionDetector（见 WrongRetentionDetector.java）会在编译时直接报出缺少 RUNTIME 保留策略的注解。在依赖中加上lintChecks 'com.jakewharton.dagger:dagger-reflect-lint:0.3.0'即可启用。

⚠️ R8 / ProGuard 需要额外配置

反射会读取类结构、注解与方法签名，因此混淆规则必须保留这些信息（keep 规则），否则运行时将出现"找不到绑定"的诡异错误。建议在调试阶段先关闭混淆验证功能，待规则完善后再开启。

模块源码速览：想深入理解就看这里

如果你希望进一步研究 full reflection 模式的实现原理，可以按下面的路径阅读源码：

• reflect/ —— 核心反射运行时库：Linker（绑定链接）、Key（依赖键）、Scope（作用域）、ComponentInvocationHandler（组件代理）等核心类都在这里；
• reflect-compiler/ —— 部分反射模式使用的增量注解处理器；
• reflect-lint/ —— 反射模式专属 Lint 规则（如 WrongRetention 检查）；
• codegen/ —— 与反射运行时配套的生成代码门面。

总结

Dagger Reflect 的 full reflection 模式，用"运行时反射"换来了"零注解处理器"的极速构建体验，特别适合依赖注入复杂、饱受编译等待之苦的 Android 项目。整个接入过程只需三步：

1. 配置依赖：通过android.injected.invoked.from.ide实现"IDE 走反射、发布走编译"；
2. 改造代码：把DaggerMyComponent.create()等三处调用替换为Dagger.create(MyComponent.class)反射 API；
3. 补齐细节：确认组件是 public 接口、注解带 RUNTIME 保留策略、配置好 R8 规则。

完成这三步，你的 IDE 构建速度将迎来肉眼可见的提升。如果还在为 Dagger 的编译速度头疼，不妨今天就试试 Dagger Reflect full reflection 模式吧！🚀

【免费下载链接】dagger-reflectA reflection-based implementation of the Dagger dependency injection library for fast IDE builds.项目地址: https://gitcode.com/gh_mirrors/da/dagger-reflect