Circuit 0.26.0 版本发布：Compose 共享元素动画与状态管理革新

项目简介

Circuit 是一个由 Slack 团队开发的现代化 Android 应用框架，它结合了 Jetpack Compose 的声明式 UI 和 Redux 风格的状态管理，为构建复杂、可维护的 Android 应用提供了优雅的解决方案。该框架特别强调单向数据流和清晰的架构分层，使得状态管理变得可预测且易于测试。

核心更新亮点

1. 共享元素动画支持（实验性）

0.26.0 版本最引人注目的特性是新增了对 Compose 共享元素动画 API 的支持。这项功能允许开发者在屏幕过渡时创建流畅的共享元素动画效果，显著提升用户体验。

实现方式： 开发者现在可以通过简单的 SharedElementTransitionLayout 包装器来启用共享元素过渡效果：

CircuitCompositionLocals(circuit) {
  SharedElementTransitionLayout {
    NavigableCircuitContent(
      navigator = navigator,
      backStack = backStack,
    )
  }
}

这个布局组件会创建并提供 SharedElementTransitionScope，内部使用标准的 Compose 共享元素/边界动画。该功能同时支持 NavigableCircuitContent 和覆盖层(overlays)。

注意事项：

• 该 API 目前标记为实验性，未来可能随 Compose 底层 API 的变化而调整
• 提供了 PreviewSharedElementTransitionLayout 用于 Compose 预览支持

2. 状态管理行为变更与增强

2.1 rememberRetained 行为调整

rememberRetained 的行为在 0.26.0 版本中进行了重要调整，使其更加符合直觉：

• 旧行为：有时会在组件重新添加时恢复值，取决于父级 RetainedStateRegistry 是否被保存
• 新行为：与 remember 和 rememberSaveable 保持一致，除非明确通过注册表保存和恢复，否则移除后重新添加的组件不会恢复其值

2.2 RetainedStateRegistry 改进

• saveAll 现在会返回保存的值
• RetainedStateRegistry.Entry.unregister 现在返回布尔值表示是否实际移除了未保存的 valueProvider
• saveAll 和 saveValue 现在会在 CanRetainChecker 返回 false 时跳过存储子值

2.3 新增 RetainedStateHolder

类似于 SaveableStateHolder，新增的 RetainedStateHolder 为特定键维护单独的 RetainedStateRegistry 条目。这使得子树可以在被释放前保存其状态，后续重新组合时能够恢复状态。

典型使用场景（如标签页切换）：

val retainedStateHolder = rememberRetainedStateHolder()
var currentTab by remember { mutableStateOf(TabA) }

retainedStateHolder.RetainedStateProvider(key = currentTab.name) {
  when (currentTab) {
    TabA -> TabAContent()
    TabB -> TabBContent()
    TabC -> TabCContent()
  }
}

3. NavigableCircuitContent 实现改进

• 从为每条记录管理单独的 RetainedStateRegistry 改为使用新的 RetainedStateHolder
• 修改 SaveableStateHolder 释放已移除记录的保存状态

其他重要更新

1. 依赖项升级：

   • 编译目标提升至 Android SDK 35
   • Compose Android BOM 更新至 2025.01.01
   • androidx.annotation 升级至 1.9.1
   • androidx.activity 升级至 1.10.0
   • Compose Android 更新至 1.7.7
   • Compose Multiplatform 更新至 1.7.3
   • Kotlin 升级至 1.9.10

2. 代码生成改进：

   • 修复了类级别 @Inject 注解导致代码生成失败的问题
   • KSP 更新至 1.9.10-1.0.29
   • Dagger 更新至 2.55
   • KotlinPoet 更新至 2.0.0

3. 示例与文档：

   • 更新了 Mosaic 示例并现代化了计数器示例以全面使用效果
   • 修复了导航文档示例中的变量大小写问题

技术深度解析

共享元素动画的实现原理

Circuit 的共享元素动画实现建立在 Compose 的基础动画 API 之上，通过 SharedTransitionScope 和 SharedTransitionLayout 提供了更高层次的抽象。这种设计允许：

1. 跨屏幕状态共享：在不同屏幕间共享元素的状态（如位置、大小）
2. 协调动画：确保源屏幕和目标屏幕的动画同步进行
3. 灵活配置：支持自定义动画曲线、持续时间和各种过渡效果

状态管理架构演进

0.26.0 版本的状态管理改进反映了 Circuit 团队对应用架构的深入思考：

1. 明确的生命周期：rememberRetained 的行为变更使得状态恢复更加明确和可控
2. 分层状态管理：RetainedStateHolder 的引入提供了更细粒度的状态控制能力
3. 内存效率：自动释放不再需要的状态有助于减少内存占用

升级建议

对于现有项目升级到 0.26.0 版本，开发者应特别注意：

1. 共享元素动画：虽然是实验性功能，但可以开始评估和测试，为未来稳定版做准备
2. rememberRetained 行为变更：检查现有代码是否依赖旧行为，必要时进行调整
3. 依赖兼容性：确保项目其他依赖与新版本的编译目标兼容

结语

Circuit 0.26.0 版本通过引入共享元素动画支持和改进状态管理机制，进一步巩固了其作为现代化 Android 开发框架的地位。这些改进不仅提升了用户体验，也使开发者能够构建更加健壮和可维护的应用。特别是状态管理方面的增强，展示了 Circuit 团队对应用架构深刻理解的持续演进。