Compose Destinations 依赖注入问题解析：如何正确使用 destination 作用域

问题背景

在使用 Compose Destinations 2.1.0 版本时，开发者遇到了一个依赖注入相关的问题。具体表现为：当尝试为特定目的地（Destination）提供依赖时，使用 destination 作用域的方式无法正常工作，而使用全局 dependency 方式则可以。

问题现象

开发者提供了两种不同的依赖注入方式：

1. 全局依赖方式（正常工作）：

DestinationsNavHost(
    dependenciesContainerBuilder = {
        dependency(checkoutExpirationDialogHandler)
        dependency(hiltViewModel<DeparturesViewModel>())
    }
)

2. 目的地作用域方式（不工作）：

DestinationsNavHost(
    dependenciesContainerBuilder = {
        destination(DeparturesScreenDestination) { checkoutExpirationDialogHandler }
        destination(DeparturesScreenDestination) { hiltViewModel<DeparturesViewModel>() }
    }
)

问题根源

经过分析，发现问题出在使用 destination 作用域时缺少了关键的 dependency() 包装方法。正确的做法应该是：

destination(DeparturesScreenDestination) { 
    dependency(hiltViewModel<DeparturesViewModel>()) 
}

技术解析

Compose Destinations 依赖注入机制

Compose Destinations 提供了两种依赖注入方式：

1. 全局依赖：使用 dependency() 方法注册的依赖对所有目的地都可用
2. 目的地作用域依赖：使用 destination(DestinationSpec) { ... } 方法注册的依赖仅对特定目的地可用

为什么需要 dependency() 包装

destination 作用域内的代码块实际上是一个 DSL 构建器，它需要明确的指令来注册依赖。直接返回依赖实例而不使用 dependency() 方法，会导致依赖没有被正确注册到依赖容器中。

正确用法对比

错误用法：

destination(DeparturesScreenDestination) { 
    hiltViewModel<DeparturesViewModel>() 
}

正确用法：

destination(DeparturesScreenDestination) { 
    dependency(hiltViewModel<DeparturesViewModel>()) 
}

最佳实践建议

1. 明确依赖作用域：根据依赖的使用范围选择全局注册或目的地作用域注册
2. 使用依赖包装：在目的地作用域内必须使用 dependency() 方法包装依赖
3. 依赖查找：在目的地内部使用 buildDependencies().require() 获取依赖时，确保类型匹配
4. 版本适配：注意不同版本间的 API 变化（如 v1 中的 dependency 方法在 v2 中更名为 destination）

总结

Compose Destinations 提供了灵活的依赖注入机制，但使用时需要注意 API 的正确调用方式。特别是在使用目的地作用域依赖时，必须使用 dependency() 方法包装依赖实例，否则依赖将无法正确注册。理解这一机制可以帮助开发者更好地组织和管理 Compose 应用中的依赖关系。