ComposeResult 是一个专为 Jetpack Compose 打造的轻量级、响应式页面通信库。它利用 CompositionLocal 和 rememberSaveable 实现了跨页面的��态共享与结果回传，优雅地取代了繁琐的 SavedStateHandle 方案。
- 极简集成：无需配置 ViewModel，无需手动管理 NavBackStackEntry。
- 响应式 UI：基于 Compose State，数据一旦设置，所有订阅页自动重组。
- 可靠的持久化：原生支持 Process Death（进程重启），数据自动通过 Bundle 恢复。
- 全架构支持：适配 Navigation 2.x、Navigation 3.0 以及所有自定义导航逻辑。
最新版本：
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
}
}
dependencies {
implementation("io.github.lans:compose-result:1.1.2")
}
ComposeResult 在 Composition 树的根部构建了一个持久化的数据中心。
- Provider:
ResultStoreProvider初始化存储空间。 - Storage: 内部使用
MutableStateMap确保响应式，并绑定Saver实现数据持久化。 - Saveable: 数据会自动挂载到 Android 系统的
SaveableStateRegistry，确保在系统回收资源后数据��丢失。
由于底层依赖 Bundle 机制，回传的数据 T 必须符合以下要求：
| 类型分类 | 具体支持 | 建议 |
|---|---|---|
| 基础类型 | Int, String, Boolean, Long, Float 等 |
直接使用 |
| 自定义对象 | 实现 Parcelable 或 Serializable 接口 |
推荐使用 @Parcelize |
| 集合/数组 | IntArray, ArrayList<T> 等 |
内部元素也需支持序列化 |
代码示例：回传自定义 Model
@Parcelize
data class UserInfo(val name: String, val age: Int) : Parcelable
// 发送数据
store.setResult(UserInfo("Lans", 18), tag = "user_info")
// 观察数据
val info by store.getResultAsState<UserInfo>(tag = "user_info")
模拟从选择器页面返回数据并自动刷新首页背景。
@Composable
fun Nav2Demo() {
val navController = rememberNavController()
ResultStoreProvider {
NavHost(navController = navController, startDestination = "home") {
composable("home") {
val store = LocalResultStore.current
// 观察结果：selectedColor 变化时，UI 自动刷新
val selectedColor by store.getResultAsState<Int?>(tag = "color_picker")
Column(
Modifier.fillMaxSize().background(selectedColor?.let { Color(it) } ?: Color.White),
verticalArrangement = Arrangement.Center,
horizontalAlignment = Alignment.CenterHorizontally
) {
Text("Nav 2.x 首页", style = MaterialTheme.typography.headlineMedium)
Button(onClick = { navController.navigate("selector") }) {
Text("去选择背景颜色")
}
}
}
composable("selector") {
val store = LocalResultStore.current
Button(onClick = {
// 设置结果并返回，home 页将自动感知
store.setResult(0xFFBBDEFB.toInt(), tag = "color_picker")
navController.popBackStack()
}) {
Text("应用蓝色")
}
}
}
}
}
在 Navigation 3 等完全由状态驱动的导航架构下，数据解耦更加彻底。
@Composable
fun Nav3Demo() {
// 导航栈状态
var backStack by rememberSaveable { mutableStateOf(listOf<NavDest>(NavDest.Dashboard)) }
ResultStoreProvider {
when (val current = backStack.last()) {
is NavDest.Dashboard -> {
val name by LocalResultStore.current.getResultAsState<String>(tag = "edit_name")
Text("用户昵称: ${name ?: "未设置"}")
Button(onClick = { backStack = backStack + NavDest.ProfileEditor }) { Text("编辑") }
}
is NavDest.ProfileEditor -> {
val store = LocalResultStore.current
Button(onClick = {
store.setResult("Lans", tag = "edit_name")
backStack = backStack.dropLast(1)
}) { Text("保存返回") }
}
}
}
}
既然 snapshotFlow 的时机和 Hilt 的注入都已经跑通了，现在的 ResultStore 已经进化成了一个全链路响应式状态总线。
在 README.md 中，我们需要清晰地展示这种“ViewModel 发送 -> 全局存储 -> UI/ViewModel 响应”的闭环能力。
首先，在你的 Hilt Module 中将 ResultStore 声明为单例，确保全应用共享同一个存储源。
@Module
@InstallIn(SingletonComponent::class)
object ResultModule {
@Provides
@Singleton
fun provideResultStore(): ResultStore = ResultStore()
}在 EntryPoint Activity 中，通过 ResultStoreProvider 将单例注入到 Compose 上下文。
@AndroidEntryPoint
class MainActivity : ComponentActivity() {
@Inject lateinit var globalStore: ResultStore
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
// 传入 globalStore 实例，禁用内部的 rememberSaveable 以配合 Hilt 生命周期
ResultStoreProvider(store = globalStore) {
MainAppNavHost()
}
}
}
}这是 ResultStore 最强大的地方：业务逻辑层与 UI 层的无感联动。
@HiltViewModel
class HomeViewModel @Inject constructor(
private val resultStore: ResultStore
) : ViewModel() {
init {
// 在 ViewModel 中“监听”全局 ResultStore 的变动
snapshotFlow { resultStore.allResults().toMap() }
.filter { resultStore.hasTag<String>("user_name") }
.onEach {
// 比如：一旦某个特定的 Key 发生变化，立即上报埋点或同步数据库
val name = resultStore.getResult<String>("user_name")
reportLoginEvent(name)
}
.launchIn(viewModelScope)
}
private fun reportLoginEvent(name: String?) {
Log.e("TAG", "reportLoginEvent $name ")
}
}在 Composable 中，你只需要像使用 LiveData 或 State 一样观察即可：
@Composable
fun ProfileScreen() {
// 自动获取全局唯一的 Store
val store = LocalResultStore.current
// 响应式状态：当 LoginViewModel 调用 setResult 时，这里会自动重组
val userName by store.getResultAsState<String>("user_name")
Text(text = "欢迎回来: ${userName ?: "游客"}")
}- 解耦：���送方（LoginViewModel）完全不需要知道接收方（ProfileScreen）的存在。
- 一致性：通过
toMap()监听，确保即使数据值改变但 Map 大小未变，也能精准触发监听。 - 灵活消费：支持
getResultAsState（持续观察）和consumeResult（阅后即焚）。
| 功能 | 纯 Compose 模式 | Hilt / 扩展模式 |
|---|---|---|
| 状态恢复 | rememberSaveable 自动恢复 |
随单例/ViewModel 存活 |
| 跨页面通信 | ✅ 支持 | ✅ 支持 |
| ViewModel 监听 | ❌ 不建议 | ✅ 完美支持 (snapshotFlow) |
| 配置复杂度 | 极低 (0 配置) | 低 (需配置 Module) |
- Tag 唯一性：请确保不同业务逻辑使用不同的
tag，建议定义常量管理。 - 数据大小：避免在 Result 中传递过大的 Bitmap 或海量列表，建议只回传数据 ID。
- 生命周期：
ResultStoreProvider的位置决定了数据的存活范围。通常建议包裹在Activity的setContent内部最外层。
Copyright 2026 Lans
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0