Jetpack 库是与 Android OS 分开提供的,因此可以独立更新,并且更新频率也可以更高。
这些库遵循严格的语义版本控制做法,以实现与预发布修订版本的新增版本间序号的二进制兼容性。版本字符串(如 1.0.1-beta02
)包含三个数字,分别代表主要、次要和 bug 修复级别。预发布版本还有一个后缀,用于指定预发布阶段(Alpha 版、Beta 版、候选版本)和版本号(01、02 等)。
请注意,我们鼓励(但并不强制要求)使用 androidx
库在次要版本之间保持源代码兼容性。原因在于,进行主要版本更新时,系统会强制要求所有依赖于之前主要版本的工件 (artifact) 都进行显式迁移,这会对开发者的工作流程造成干扰。
库的每个版本都要经历三个预发布阶段,才能成为稳定版本。各预发布阶段的标准如下:
Alpha 版
- Alpha 版功能稳定,但功能可能不完整。
- 在版本处于 Alpha 版阶段时,可以添加、移除或更改 API。
Beta 版
- Beta 版功能稳定,并且具有功能完整的 API Surface。
- 这个版本可以投入实际使用,但可能包含 bug。
- Beta 版无法使用实验性编译器功能(例如
@UseExperimental
)。 - 依赖于其他库的资源必须为 Beta 版、RC 版或稳定版。不允许使用 Alpha 版依赖项。
候选版本 (RC)
- 候选版本是潜在的稳定版。
- 此版本可能包含在最后一刻提供的重要修复。
- 此版本的 API Surface 无法更改。
- 依赖于其他库的资源必须为 RC 版或稳定版。
一个库可以同时具有多个版本。每个版本处在不同的发布阶段。例如,虽然 androidx.activity
的稳定版可以是 1.0.0
,但也可能还有 1.1.0-beta02
版本以及 2.0.0-alpha01
版本。
通过本页面可以了解库的最新更新。
AndroidX 最新版本说明页面会列出最近更改过的库。Google 的 Maven 制品库会显示完整的版本记录。
在下表中可以查看每个 AndroidX 库的最新稳定版和预览版。每行中的链接指向相应库的版本说明。在版本说明中,您会找到以下信息:
- 所有版本的历史记录(按时间先后顺序排列)。
- 一个代码段,其中包含为使用工件而需要进行的默认 Gradle 依赖项声明。
- 指向各工件中软件包的 Kotlin 和 Java 参考页面的链接。
Jetpack 库
某些 AndroidX 库(如相机)具有多个工件,这些工件需要单独维护。这类库标有星号 (*)。要查看所有工件的版本更新,请参阅版本说明。
(*) 此库包含多个工件。如需了解详情,请参阅其版本说明。
上次更新时间:2024 年 5 月 1 日