accompanist

Accompanist是一组旨在为Jetpack Compose补充开发者常用但尚未提供的功能的库。

Accompanist是一个类似实验室环境的新Compose API。我们利用它来填补Compose工具包中已知的空白，尝试新的API，并深入了解开发Compose库的开发体验。这些库的目标是将其纳入官方工具包，届时它们将被弃用并从Accompanist中移除。

有关更多详细信息，比如为什么这个库存在？为什么它不是AndroidX的一部分？你们会发布更多库吗？请查看我们的Accompanist常见问题。

Compose版本

每个发布版本都概述了它所依赖的Compose UI库的版本。我们目前正在为不同版本的Compose发布多个版本的Accompanist：

<table> <tr> <td>Compose 1.0 (1.0.x)</td><td><img alt="Maven Central" src="https://img.shields.io/maven-central/v/com.google.accompanist/accompanist-permissions?versionPrefix=0.20"></td> </tr> <tr> <td>Compose 1.1 (1.1.x)</td><td><img alt="Maven Central" src="https://img.shields.io/maven-central/v/com.google.accompanist/accompanist-permissions?versionPrefix=0.23"></td> </tr> <tr> <td>Compose UI 1.2 (1.2.x)</td><td><img alt="Maven Central" src="https://img.shields.io/maven-central/v/com.google.accompanist/accompanist-permissions?versionPrefix=0.25"></td> </tr> <tr> <td>Compose UI 1.3 (1.3.x)</td><td><img alt="Maven Central" src="https://img.shields.io/maven-central/v/com.google.accompanist/accompanist-permissions?versionPrefix=0.28"></td> </tr> <tr> <td>Compose UI 1.4 (1.4.x)</td><td><img alt="Maven Central" src="https://img.shields.io/maven-central/v/com.google.accompanist/accompanist-permissions?versionPrefix=0.30"></td> </tr> <tr> <td>Compose UI 1.5 (1.5.x)</td><td><img alt="Maven Central" src="https://img.shields.io/maven-central/v/com.google.accompanist/accompanist-permissions?versionPrefix=0.32"></td> </tr> <tr> <td>Compose UI 1.6 (1.6.x)</td><td><img alt="Maven Central" src="https://img.shields.io/maven-central/v/com.google.accompanist/accompanist-permissions?versionPrefix=0.34"></td> </tr> <tr> <td>Compose UI 1.7 (1.7.x)</td><td><img alt="Maven Central" src="https://img.shields.io/maven-central/v/com.google.accompanist/accompanist-permissions"></td> </tr> </table>

对于Compose的稳定版本，我们使用最新的稳定版Compose编译器。对于非稳定版本（alpha、beta等），我们使用发布时的最新编译器。

:warning: 确保你使用的Accompanist版本与你的Compose UI版本匹配：如果你升级Accompanist，它将通过传递依赖升级你的Compose库版本。

库

📫 权限

一个为Jetpack Compose提供Android运行时权限支持的库。

🖌️ Drawable绘制器

一个提供将Android Drawable用作Jetpack Compose绘制器的方法的库。

📜 自适应

一个提供自适应布局实用工具集合的库。

⬇️ 下拉刷新 (已弃用)

请参阅我们的迁移指南以迁移到Compose Material中的PullRefresh。

🎨 AppCompat主题适配器 (已弃用)

请参阅我们的迁移指南以迁移到Accompanist中的新组件。

📖 分页器 (已弃用)

请参阅我们的迁移指南以迁移到Compose中的Pager。

🌊 流式布局 (已弃用)

请参阅我们的迁移指南以迁移到Compose中的FlowLayout。

🧭✨导航动画 (已弃用)

请参阅我们的迁移指南以迁移到Jetpack Navigation Compose中内置的动画支持。

🧭🎨️ 导航材料 (已弃用)

请参阅我们的迁移指南以迁移到内置的材料导航支持。

⏳ 占位符 (已弃用)

一个提供易于使用的修饰符，用于在内容加载时显示占位符UI的库。

🍫 系统UI控制器 (已弃用)

我们建议迁移到边缘到边缘。有关更多详细信息，请参阅我们的迁移指南。

🎨 AppCompat主题适配器 (已弃用)

一个能够在Jetpack Compose中重用AppCompat XML主题进行主题设置的库。

🎨 Material主题适配器 (已弃用)

一个能够在Jetpack Compose中重用MDC-Android Material 2 XML主题进行主题设置的库。

🎨 Material 3主题适配器 (已弃用)

一个能够在Jetpack Compose中重用MDC-Android Material 3 XML主题进行主题设置的库。

🌏 Web (已弃用)

一个用于在Jetpack Compose中提供基本WebView支持的WebView包装器。

🗜 测试工具 (已弃用)

用于测试Compose布局的实用工具。

📐 插图 (已弃用并移除)

请参阅我们的迁移指南以迁移到Compose中的Insets。

---

未来？

这组库中的任何功能在未来可能会变得过时，届时它们（可能）会被弃用。

我们将尽可能提供迁移路径，以替代该功能。

快照版本

Accompanist的当前开发版本的快照是可用的，它们跟踪最新的提交。有关更多信息，请参见此处。

---

为什么叫这个名字？

这个库主要是为Compose添加一些实用工具。音乐作曲是由作曲家完成的，由于这个库是关于支持组合的，所以伴奏者这个支持角色的名称感觉很合适。

贡献

欢迎贡献！我们将愉快地审查任何拉取请求。 不过请先阅读贡献页面。

许可证

Copyright 2020 The Android Open Source Project
 
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

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.