Jetpack 库与 Android 操作系统分开发布,因此库的更新可以独立且更频繁地进行。
这些库遵循严格的语义化版本控制,以保证二进制兼容性,并增加了版本间的预发布修订序列。版本字符串(例如1.0.1-beta02
)包含三个数字,分别代表主版本、次版本和修补程序级别。预发布版本还有一个后缀,用于指定预发布阶段(alpha、beta、候选发布版本)和修订号(01、02 等)。
请注意,鼓励androidx
库在次要版本之间保持源代码兼容性,但这并非强制要求。原因是:主版本更新会强制所有依赖于先前主版本的人工制品进行显式迁移,这会扰乱开发人员的工作流程。
每个库的每个版本在成为稳定版本之前都会经历三个预发布阶段。每个预发布阶段的标准是:
Alpha
- Alpha 版本在功能上是稳定的,但可能不具备完整的功能。
- 在 Alpha 阶段,API 可能会被添加、删除或更改。
Beta
- Beta 版本在功能上是稳定的,并且具有功能完整的 API 表面。
- 它们已准备好用于生产环境,但可能包含错误。
- Beta 版本不能使用实验性编译器功能(例如
@UseExperimental
)。 - 对其他库的依赖必须是 beta、rc 或稳定版本。不允许使用 alpha 版本的依赖项。
候选发布版本 (RC)
- 候选发布版本是预期的稳定版本。
- 它可能包含关键的最后一刻修复。
- 它的 API 表面是最终的。
- 对其他库的依赖只能是 rc 或稳定版本。
一个库可以同时拥有多个版本。每个版本都有不同的发布阶段。例如,虽然androidx.activity
的稳定版本可能是1.0.0
,但也可能存在1.1.0-beta02
版本以及2.0.0-alpha01
版本。
请访问此页面,了解这些库的最新更新。
AndroidX 最新发布说明页面此处列出了最近发生更改的库。Google 的Maven 存储库显示了完整的版本历史记录。
使用下表查看每个 AndroidX 库的最新稳定版本和预览版本。每一行的链接都会带您到该库的发布说明。在发布说明中,您会找到:
- 所有版本的编年史。
- 包含用于使用构件的默认 Gradle 依赖项声明的代码片段。
- 指向每个构件中包的 Kotlin 和 Java 参考页面的链接。
Jetpack 库
某些 AndroidX 库(例如 camera)具有多个单独维护的构件。这些库用星号 (*) 标记。请参阅发布说明以查看所有构件的版本更新。