1. 什么是 Accompanist 及其用途

Accompanist 是 Google 团队为 Jetpack Compose 开发的一组扩展库集合。它为那些尚未纳入 Compose 稳定 API 或需要从零开始复杂实现的任务提供了现成的解决方案。该库解决了每个 Compose 开发者都会遇到的问题：手势处理、系统栏、动画、WebView、多屏幕适配等等。

为什么需要它？首先，Accompanist 节省时间。您无需编写自己的手势处理器或用于系统栏的自定义修饰符，而是使用现成的、经过测试的组件。其次，该库遵循 Google 的官方建议，并且常常成为未来 Compose 稳定 API 的原型。例如，Accompanist 中的 HorizontalPager 后来被添加到 Compose Foundation 中作为 HorizontalPager。

在撰写本文时，Accompanist 包含以下模块：systemuicontroller（管理状态栏和导航栏）、permissions（运行时权限请求）、webview（嵌入 WebView）、pager（水平/垂直页面滚动）、swiperefresh（下拉刷新手势）、placeholder（骨架屏加载）、adaptive（自适应布局）、navigation-animation（过渡动画）等。

2. 安装

Accompanist 是一个用于 Gradle（Android/Kotlin Multiplatform）的库。安装通过在模块的 build.gradle.kts（或 build.gradle）文件中添加依赖项来完成。不使用 pip、npm、cargo 或 go get 命令，因为它不是 Python、JavaScript、Rust 或 Go。

添加特定模块（例如 systemuicontroller）的确切命令：

// build.gradle.kts (Module)\ndependencies {\n    implementation("com.google.accompanist:accompanist-systemuicontroller:0.34.0")\n    // 对于其他模块：\n    // implementation("com.google.accompanist:accompanist-permissions:0.34.0")\n    // implementation("com.google.accompanist:accompanist-pager:0.34.0")\n    // implementation("com.google.accompanist:accompanist-swiperefresh:0.34.0")\n    // implementation("com.google.accompanist:accompanist-webview:0.34.0")\n    // implementation("com.google.accompanist:accompanist-placeholder:0.34.0")\n}

重要提示：请在 GitHub Releases 上检查最新版本。0.34.0 版本是撰写本文时的最新稳定版本。请确保您的 Kotlin 和 Compose 版本与所选 Accompanist 版本兼容。

3. 快速入门——最小工作示例

创建一个屏幕，点击按钮时改变状态栏颜色。为此，我们使用 systemuicontroller 模块。

import androidx.compose.foundation.background\nimport androidx.compose.foundation.layout.*\nimport androidx.compose.material3.*\nimport androidx.compose.runtime.*\nimport androidx.compose.ui.Modifier\nimport androidx.compose.ui.graphics.Color\nimport androidx.compose.ui.unit.dp\nimport com.google.accompanist.systemuicontroller.rememberSystemUiController\n\n@Composable\nfun QuickStartExample() {\n    val systemUiController = rememberSystemUiController()\n    var isDark by remember { mutableStateOf(false) }\n\n    // 根据状态设置状态栏颜色\n    LaunchedEffect(isDark) {\n        if (isDark) {\n