访问官网
GithubCompose 稳定标记
✒️ Compose 稳定标记源自 Compose 运行时，它通过向 Compose 编译器传达稳定性和可跳过性保证，从而提高非 Compose 依赖模块的性能。该库支持 Kotlin 多平台。
### 不使用 Stable 注解（不可跳过且不稳定） 假设你有一个没有 `Stable` 注解的普通类： ```kotlin // 数据模块（纯 Kotlin 模块） public data class UnstableUser( public val name: String, public val devices: List
// 特性模块 @Composable private fun UnstableUserFun(unstableUser: UnstableUser) { Text(text = unstableUser.toString()) }
根据 [Compose 编译器指标](https://github.com/androidx/androidx/blob/androidx-main/compose/compiler/design/compiler-metrics.md)，你将得到以下结果：
restartable scheme("[androidx.compose.ui.UiComposable]") fun UnstableUserFun( unstable unstableUser: UnstableUser )
如上面的指标所示，`UnstableUserFun` Composable 函数是**不可跳过**的，而 `UnstableUser` 类被标记为**不稳定**。
### 使用 Stable 注解（可跳过且稳定）
假设你有一个带有 `Stable` 注解的普通类：
```kotlin
// 数据模块（纯 Kotlin 模块）
@Immutable
public data class StableUser(
public val name: String,
public val devices: List<String>,
public val createdAt: Instant,
)
// 特性模块
@Composable
private fun StableUserFun(stableUser: StableUser) {
Text(text = stableUser.toString())
}
根据 Compose 编译器指标，你将得到以下结果：
restartable skippable scheme("[androidx.compose.ui.UiComposable]") fun StableUserFun(
stable stableUser: StableUser
)
如上面的指标所示，StableUserFun Composable 函数是可跳过的，而 StableUser 类被标记为稳定。因此，如果参数自上次调用以来没有变化，你的函数将完全跳过调用，因为所有属性都被标记为稳定。
Immutable
与 Stable 注解的方法相同，你可以像使用普通的 compose-runtime 注解一样使用这个注解。顾名思义，这些持有不可变数据。由于数据永远不会改变，Compose 可以将其视为稳定数据。使用此注解，Composition 可以基于假设从类型读取的值不会改变来启用优化。
假设你有一个带有 Immutable 注解的普通类：
// 数据模块（纯 Kotlin 模块）
@Immutable
public data class ImmutableUser constructor(
public val name: String,
public val devices: List<String>,
public val createdAt: Instant,
)
// 特性模块
@Composable
private fun ImmutableUserComposable(immutableUser: ImmutableUser) {
Text(text = immutableUser.toString())
}
根据 Compose 编译器指标，你将得到以下结果：
restartable skippable scheme("[androidx.compose.ui.UiComposable]") fun ImmutableUser(
stable immutableUser: ImmutableUser
)
StableMarker
标记为 StableMarker 的注解表示一个稳定类型，它遵循以下假设：
- 对于相同的两个实例，[equals] 的结果将始终返回相同的结果。
- 当类型的公共属性发生变化时，将通知 Composition。
- 所有公共属性类型都是稳定的。
许可证
由 skydoves (Jaewoong Eum) 于2023年设计和开发
根据 Apache 许可证 2.0 版（"许可证"）授权；
除非遵守许可证，否则您不得使用此文件。
您可以在以下网址获取许可证副本：
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意，否则根据许可证分发的软件是基于"按原样"分发的，
不附带任何明示或暗示的担保或条件。
有关许可证下的特定语言管理权限和限制，请参阅许可证。
