Dagger 2.56 发布：全面支持Jakarta与Kotlin集合优化

项目简介

Dagger 是 Google 开发的一款轻量级依赖注入框架，专门为 Java 和 Kotlin 应用程序设计。它通过编译时代码生成的方式实现依赖注入，避免了传统依赖注入框架在运行时可能带来的性能问题。Dagger 2 是该框架的第二代版本，相比第一代在性能和易用性上都有显著提升。

主要更新内容

Jakarta 支持全面升级

本次发布的 Dagger 2.56 版本在 Jakarta 支持方面做出了重要改进：

1. 移除废弃方法：删除了接受 javax.inject.Provider 参数的工厂创建方法。这意味着如果使用旧版 Dagger 构建组件，但依赖项来自新版 Dagger 的工厂，将无法编译通过。解决方案是升级编译组件的 Dagger 版本。

2. 限制 Provider 使用：现在禁止提供或注入 dagger.internal.Provider，同时禁止在 Map 中注入原始 Provider（包括 javax 和 dagger 的 Provider）。

3. Hilt 支持：增加了对 Hilt 框架中 Jakarta 注解的支持，使 Hilt 用户也能享受到 Jakarta 生态系统的优势。

Kotlin 集合类型规范

对于 Kotlin 用户，Dagger 2.56 做出了一个重要变更：

• 在 Kotlin 源文件中使用 @Multibinds 和 @ElementsIntoSet 注解时，现在必须使用 kotlin.collections 包中的 Set/Map，而不是 java.util 包中的对应类。这一变更使 Kotlin 代码更加符合语言习惯，减少了 Java 和 Kotlin 集合类型之间的隐式转换。

其他重要改进

1. 私有修饰符优化：移除了 Dagger 生成组件私有实现类中字段/方法的 private 修饰符，解决了 #4544 问题，提高了代码的灵活性和可访问性。

2. Hilt 项目隔离修复：部分解决了 #4423 问题，修复了检查 Hilt 库是否与 Gradle 插件一起应用时的项目隔离违规问题。

3. Kotlin 版本升级：将 Kotlin 升级到 2.1.10 以支持 KSP 2.1.10-1.0.31。需要注意的是，这会破坏与较旧 Gradle 版本（8.10.2 或更低）的兼容性，使用 Hilt Gradle 插件的预编译脚本插件（包含的构建）将无法编译。

技术影响与最佳实践

迁移建议

对于正在使用 Jakarta 生态系统的开发者：

1. 检查项目中是否有使用 javax.inject.Provider 的代码，及时迁移到 jakarta.inject.Provider。

2. 确保所有依赖的 Dagger 组件使用相同或兼容的版本，避免因版本不一致导致的编译问题。

对于 Kotlin 开发者：

1. 检查项目中 @Multibinds 和 @ElementsIntoSet 注解的使用，确保使用的是 kotlin.collections 包中的集合类型。

2. 如果项目使用较旧的 Gradle 版本，考虑升级到 8.10.2 以上版本以避免兼容性问题。

性能考量

移除私有修饰符可能会对某些优化产生影响，但通常这种影响可以忽略不计。开发者应该关注的是代码的可维护性和清晰度，而不是微小的性能差异。

总结

Dagger 2.56 版本标志着框架在 Jakarta 生态系统支持和 Kotlin 语言集成方面迈出了重要一步。这些变更虽然带来了一些破坏性变化，但为未来的发展奠定了更好的基础。开发者应该根据项目实际情况规划升级路径，充分利用新版本带来的改进和优化。