Compose Destinations 跨模块导航与自定义参数序列化实践

理解Compose导航中的模块化挑战

在现代Android应用开发中，模块化架构已成为主流趋势。Compose Destinations作为Jetpack Compose的导航库，提供了类型安全的导航解决方案。但在多模块项目中，开发者常会遇到跨模块导航的挑战，特别是当需要传递复杂数据对象作为参数时。

问题场景分析

假设我们有一个多模块项目，其中模块A需要导航到模块B的某个界面，并传递一个自定义数据类Things作为参数。Things是一个简单的数据类，包含两个字符串属性：

data class Things(val first: String, val second: String)

开发者尝试通过自定义NavTypeSerializer来实现参数的序列化和反序列化，但发现序列化方法toRouteString()没有被调用，而反序列化时却得到了不符合预期的字符串格式。

正确实现跨模块导航

1. 声明模块B的目的地

首先在模块B中正确定义可组合目的地：

@Destination
@Composable
fun TestScreen(things: Things) {
    Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
        Text(text = things.first, style = MaterialTheme.typography.headlineMedium)
    }
}

2. 实现自定义参数序列化器

为Things类创建序列化器：

@NavTypeSerializer
class ThingsNavTypeSerializer : DestinationsNavTypeSerializer<Things> {
    override fun toRouteString(value: Things): String {
        return "${value.first};${value.second}"
    }

    override fun fromRouteString(routeStr: String): Things {
        val parts = routeStr.split(";")
        return Things(first = parts[0], second = parts[1])
    }
}

3. 跨模块导航的正确方式

关键点在于使用类型安全的导航API而非手动构建路由字符串。在模块A中应该这样导航：

// 错误方式: navigator.navigate("test_screen/$data")
// 正确方式:
navigator.navigate(TestScreenDestination(data))

模块化架构下的解决方案

要实现模块间的解耦和类型安全导航，需要：

1. 在核心模块声明公共目的地接口：定义模块间需要共享的目的地契约
2. 在各模块实现具体目的地：每个模块负责自己的界面实现
3. 通过依赖注入或服务定位：在导航时获取目标目的地的引用

最佳实践建议

1. 始终使用生成的Destination类导航：避免手动拼接路由字符串
2. 为复杂参数实现序列化器：确保数据能正确转换为路由字符串
3. 模块间共享最小必要信息：只传递必要数据，保持模块独立性
4. 考虑使用Parcelable替代：对于复杂对象，评估是否更适合使用Parcelable传递

总结

Compose Destinations为模块化应用提供了强大的导航支持，但需要遵循其类型安全的设计理念。通过正确使用生成的Destination类和自定义参数序列化器，开发者可以构建既安全又可维护的跨模块导航系统。记住，避免手动构建路由字符串是防止导航问题的关键。