Compose Destinations 库中 ResultRecipientImpl 的生命周期处理优化

Compose Destinations 是一个用于 Jetpack Compose 的导航库，它简化了导航和参数传递的过程。最近在版本 2.2.0 中，该库对 ResultRecipientImpl 的生命周期处理进行了重要优化，解决了在某些特定场景下结果过早传递的问题。

问题背景

在原始实现中，ResultRecipientImpl 的 onNavResult 方法会在 ON_START 生命周期阶段处理结果。这种设计在大多数情况下工作良好，但在某些特殊场景下会导致问题：

1. 当父屏幕打开一个底部表单（BottomSheet）时
2. 用户在底部表单中操作数据并通过 resultNavigator.setResult() 发送结果
3. 如果用户将应用置于后台后再恢复，父屏幕会在 ON_START 阶段接收到结果
4. 这导致当用户真正关闭底部表单时，结果已经被消费而无法再次传递

技术分析

问题的核心在于生命周期阶段的选择。ON_START 阶段在某些情况下（如底部表单或对话框覆盖时）会被触发，而 ON_RESUME 则不会。这导致了结果在不恰当的时机被消费。

原始实现选择 ON_START 的原因是为了兼容一些特殊目的地类型（如对话框和底部表单），在这些情况下 ON_RESUME 可能不会被触发。

解决方案

Compose Destinations 2.2.0 版本引入了更灵活的生命周期处理策略：

1. 保留了原有的 ON_FIRST_OPPORTUNITY 默认行为（在 ON_START 或 ON_RESUME 中处理，以先触发的为准）
2. 新增了 ON_RESUME 选项，开发者可以根据需要选择只在 ON_RESUME 阶段处理结果

这种设计既保持了向后兼容性，又为特定场景提供了更精确的控制。

实际应用

对于需要精确控制结果传递时机的场景（如底部表单或对话框），开发者现在可以：

onNavResult(
    navBackStackEntry = navBackStackEntry,
    lifecycleOwner = lifecycleOwner,
    resultRecipient = resultRecipient,
    lifecycleState = Lifecycle.State.RESUMED
) { result ->
    // 处理结果
}

这种配置确保了结果只在屏幕真正恢复时被处理，避免了应用从后台恢复时的意外结果消费。

总结

Compose Destinations 的这次更新展示了良好的API设计理念：

1. 保持向后兼容性
2. 为特殊场景提供扩展点
3. 让开发者能够根据具体需求选择最适合的行为

对于使用底部表单或对话框等场景的开发者，建议评估是否需要使用新的 ON_RESUME 选项来获得更精确的结果处理时机控制。