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 参考页面的链接。
AI 提示
将所有库升级到最新的稳定版
此提示会将所有过时库升级到最新的稳定版本。它会告知您任何不兼容性问题或应进行的进一步更改。
在 Android Studio 中运行此提示,并打开版本目录文件。
Upgrade any library versions in my project that are out of date. Use the latest stable version of any libraries. Inform me if there's any libraries that are likely to be incompatible, and if there are any other changes to code I need to make in my project caused by upgrading to these new versions.
Jetpack 库
某些 AndroidX 库(如相机)具有多个工件,这些工件需要单独维护。这类库标有星号 (*)。要查看所有工件的版本更新,请参阅版本说明。
Maven 组 ID | 最近更新时间 | 稳定版 | 候选版 | Beta 版 | Alpha 版 |
---|---|---|---|---|---|
activity | 2024 年 12 月 11 日 | 1.9.3 | 1.10.0-rc01 | - | - |
ads | 2023 年 3 月 8 日 | - | - | - | 1.0.0-alpha05 |
annotation (*) | 2024 年 10 月 30 日 | 1.9.1 | - | - | - |
appcompat | 2024 年 5 月 29 日 | 1.7.0 | - | - | - |
appsearch | 2024 年 12 月 11 日 | - | - | - | 1.1.0-alpha07 |
arch.core | 2023 年 2 月 22 日 | 2.2.0 | - | - | - |
asynclayoutinflater | 2022 年 10 月 5 日 | 1.0.0 | - | - | 1.1.0-alpha01 |
autofill | 2024 年 9 月 18 日 | 1.1.0 | - | 1.3.0-beta01 | - |
benchmark | 2024 年 12 月 11 日 | 1.3.3 | - | - | 1.4.0-alpha06 |
biometric | 2024 年 8 月 7 日 | 1.1.0 | - | - | 1.4.0-alpha02 |
bluetooth | 2023 年 11 月 29 日 | - | - | - | 1.0.0-alpha02 |
browser | 2024 年 3 月 6 日 | 1.8.0 | - | - | - |
car-app | 2024 年 11 月 13 日 | 1.4.0 | - | 1.7.0-beta03 | - |
camera (*) | 2024 年 12 月 11 日 | 1.4.1 | - | - | 1.5.0-alpha04 |
camera.media3 | 2024 年 12 月 11 日 | - | - | - | 1.0.0-alpha01 |
camera.viewfinder (*) | 2024 年 12 月 11 日 | - | - | - | 1.4.0-alpha11 |
cardview | 2018 年 9 月 21 日 | 1.0.0 | - | - | - |
collection | 2024 年 12 月 11 日 | 1.4.5 | - | 1.5.0-beta01 | - |
compose | 2024 年 8 月 7 日 | 1.4.5 | - | 1.5.0-beta01 | - |
compose.animation | 2024 年 12 月 11 日 | 1.7.6 | - | - | 1.8.0-alpha07 |
compose.compiler | 2024 年 8 月 7 日 | 1.5.15 | - | - | - |
compose.foundation | 2024 年 12 月 11 日 | 1.7.6 | - | - | 1.8.0-alpha07 |
compose.material | 2024 年 12 月 11 日 | 1.7.6 | - | - | 1.8.0-alpha07 |
compose.material3 | 2024 年 11 月 13 日 | 1.3.1 | - | - | 1.4.0-alpha04 |
compose.material3.adaptive | 2024 年 11 月 13 日 | 1.0.0 | - | - | 1.1.0-alpha07 |
compose.runtime | 2024 年 12 月 11 日 | 1.7.6 | - | - | 1.8.0-alpha07 |
compose.ui | 2024 年 12 月 11 日 | 1.7.6 | - | - | 1.8.0-alpha07 |
concurrent | 2024 年 12 月 11 日 | 1.2.0 | - | - | 1.3.0-alpha01 |
constraintlayout (*) | 2024 年 10 月 30 日 | 2.2.0 | - | - | - |
contentpager | 2018 年 9 月 21 日 | 1.0.0 | - | - | - |
coordinatorlayout | 2023 年 10 月 4 日 | 1.2.0 | - | - | 1.3.0-alpha02 |
core (*) | 2024 年 12 月 11 日 | 1.15.0 | - | - | 1.16.0-alpha01 |
core.uwb | 2024 年 12 月 11 日 | - | - | - | 1.0.0-alpha10 |
credentials | 2024 年 10 月 30 日 | 1.3.0 | - | 1.5.0-beta01 | 1.5.0-beta01 |
credentials.registry | 2024 年 10 月 16 日 | - | - | - | 1.0.0-alpha01 |
cursoradapter | 2018 年 9 月 21 日 | 1.0.0 | - | - | - |
customview (*) | 2022 年 9 月 21 日 | 1.1.0 | - | - | 1.2.0-alpha02 |
databinding | 2019 年 9 月 5 日 | 3.5.0 | - | - | 3.6.0-alpha10 |
datastore | 2024 年 5 月 1 日 | 1.1.1 | - | - | - |
documentfile | 2021 年 8 月 18 日 | 1.0.1 | - | - | 1.1.0-alpha01 |
draganddrop | 2022 年 5 月 11 日 | 1.0.0 | - | - | - |
drawerlayout | 2023 年 3 月 22 日 | 1.2.0 | - | - | - |
dynamicanimation | 2019 年 12 月 4 日 | 1.0.0 | - | - | 1.1.0-alpha03 |
emoji | 2021 年 1 月 27 日 | 1.1.0 | - | - | 1.2.0-alpha03 |
emoji2 | 2024 年 9 月 4 日 | 1.5.0 | - | - | - |
enterprise | 2021 年 1 月 13 日 | 1.1.0 | - | - | - |
exifinterface | 2024 年 11 月 13 日 | 1.3.7 | - | - | 1.4.0-alpha01 |
fragment | 2024 年 10 月 30 日 | 1.8.5 | - | - | - |
games (*) | 2024 年 10 月 16 日 | 3.0.5 | - | - | 4.0.0-alpha01 |
glance | 2024 年 10 月 16 日 | 1.1.1 | - | - | - |
graphics (*) | 2024 年 12 月 11 日 | 1.0.2 | - | - | - |
gridlayout | 2023 年 5 月 24 日 | 1.0.0 | - | 1.1.0-beta01 | - |
health | 2024 年 12 月 11 日 | - | 1.0.0-rc02 | - | 1.1.0-alpha05 |
health.connect | 2024 年 10 月 16 日 | - | - | - | 1.1.0-alpha10 |
heifwriter | 2024 年 10 月 2 日 | - | - | - | 1.1.0-alpha03 |
hilt (*) | 2024 年 2 月 21 日 | 1.2.0 | - | - | - |
ink | 2024 年 12 月 11 日 | - | - | - | 1.0.0-alpha02 |
input | 2024 年 10 月 2 日 | - | - | 1.0.0-beta05 | - |
interpolator | 2018 年 9 月 21 日 | 1.0.0 | - | - | - |
javascriptengine | 2023 年 11 月 1 日 | - | - | 1.0.0-beta01 | - |
jetifier | 2020 年 9 月 2 日 | - | - | 1.0.0-beta10 | - |
leanback | 2023 年 11 月 15 日 | 1.0.0 | 1.1.0-rc02 | - | 1.2.0-alpha04 |
legacy | 2018 年 9 月 21 日 | 1.0.0 | - | - | - |
lifecycle (*) | 2024 年 12 月 11 日 | 2.8.7 | - | - | 2.9.0-alpha08 |
lint | 2024 年 12 月 11 日 | - | - | - | 1.0.0-alpha03 |
loader | 2019 年 10 月 9 日 | 1.1.0 | - | - | - |
localbroadcastmanager | 2022 年 1 月 12 日 | 1.1.0 | - | - | - |
media | 2023 年 11 月 29 日 | 1.7.0 | - | - | - |
media2 | 2024 年 1 月 10 日 | 1.3.0 | - | - | - |
media3 | 2024 年 11 月 27 日 | 1.5.0 | - | - | - |
mediarouter | 2024 年 12 月 11 日 | 1.7.0 | - | - | 1.8.0-alpha01 |
multidex | 2018 年 12 月 17 日 | 2.0.1 | - | - | - |
metrics | 2024 年 1 月 10 日 | - | - | 1.0.0-beta01 | - |
navigation | 2024 年 12 月 11 日 | 2.8.5 | - | - | 2.9.0-alpha04 |
paging (*) | 2024 年 12 月 11 日 | 3.3.5 | - | - | - |
palette | 2018 年 9 月 21 日 | 1.0.0 | - | - | - |
2024 年 12 月 11 日 | - | - | - | 1.0.0-alpha05 | |
percentlayout | 2018 年 9 月 21 日 | 1.0.0 | - | - | - |
preference | 2023 年 7 月 26 日 | 1.2.1 | - | - | - |
2020 年 10 月 28 日 | - | - | 1.1.0-beta01 | - | |
privacysandbox.activity | 2023 年 11 月 15 日 | - | - | - | 1.0.0-alpha01 |
privacysandbox.ads | 2024 年 10 月 30 日 | - | - | 1.1.0-beta11 | - |
privacysandbox.plugins | 2023 年 8 月 9 日 | - | - | - | 1.0.0-alpha02 |
privacysandbox.sdkruntime | 2024 年 12 月 11 日 | - | - | - | 1.0.0-alpha16 |
privacysandbox.tools | 2024 年 10 月 2 日 | - | - | - | 1.0.0-alpha10 |
privacysandbox.ui | 2024 年 12 月 11 日 | - | - | - | 1.0.0-alpha12 |
profileinstaller | 2024 年 10 月 2 日 | 1.4.1 | - | - | - |
recommendation | 2018 年 9 月 21 日 | 1.0.0 | - | - | - |
recyclerview (*) | 2024 年 9 月 18 日 | 1.3.2 | 1.4.0-rc01 | - | - |
remotecallback | 2019 年 5 月 7 日 | 1.0.0 | - | - | - |
resourceinspection | 2022 年 1 月 26 日 | 1.0.1 | - | - | - |
room | 2024 年 12 月 11 日 | 2.6.1 | - | - | 2.7.0-alpha12 |
savedstate | 2024 年 12 月 11 日 | 1.2.1 | - | - | 1.3.0-alpha06 |
security (*) | 2024 年 8 月 7 日 | 1.0.0 | - | - | 1.1.0-alpha06 |
sharetarget | 2022 年 10 月 5 日 | 1.2.0 | - | - | - |
slice | 2021 年 1 月 13 日 | - | - | - | 1.1.0-alpha02 |
slidingpanelayout | 2022 年 1 月 26 日 | 1.2.0 | - | - | - |
startup | 2024 年 9 月 18 日 | 1.2.0 | - | - | - |
sqlite | 2024 年 12 月 11 日 | 2.4.0 | - | - | 2.5.0-alpha12 |
swiperefreshlayout | 2020 年 7 月 22 日 | 1.1.0 | - | - | 1.2.0-alpha01 |
test (*) | 2024 年 11 月 20 日 | 1.0.1 | - | - | 1.1.0-alpha04 |
test.uiautomator | 2024 年 6 月 26 日 | 2.3.0 | - | - | 2.4.0-alpha01 |
textclassifier | 2022 年 3 月 23 日 | - | - | - | 1.0.0-alpha04 |
tracing | 2023 年 11 月 29 日 | 1.2.0 | - | - | 1.3.0-alpha02 |
transition | 2024 年 12 月 11 日 | 1.5.1 | - | - | 1.6.0-alpha01 |
tv | 2024 年 8 月 21 日 | 1.0.0 | - | - | - |
tvprovider | 2020 年 8 月 19 日 | - | - | - | 1.1.0-alpha01 |
vectordrawable | 2024 年 5 月 1 日 | 1.2.0 | - | - | - |
versionedparcelable | 2024 年 1 月 10 日 | 1.2.0 | - | - | - |
viewpager | 2024 年 12 月 11 日 | 1.1.0 | - | - | - |
viewpager2 | 2024 年 5 月 14 日 | 1.1.0 | - | - | - |
wear (*) | 2024 年 12 月 11 日 | 1.3.0 | - | - | 1.4.0-alpha01 |
wear.compose | 2024 年 12 月 11 日 | 1.4.0 | - | - | 1.5.0-alpha07 |
wear.protolayout | 2024 年 12 月 11 日 | 1.2.1 | - | - | 1.3.0-alpha05 |
wear.tiles | 2024 年 12 月 11 日 | 1.4.1 | - | - | 1.5.0-alpha05 |
wear.watchface | 2024 年 9 月 18 日 | 1.2.1 | - | - | 1.3.0-alpha04 |
webkit | 2024 年 12 月 11 日 | 1.9.0 | - | - | 1.13.0-alpha02 |
window | 2024 年 10 月 16 日 | 1.3.0 | - | - | 1.4.0-alpha05 |
window.extensions.core | 2023 年 6 月 7 日 | 1.0.0 | - | - | - |
work | 2024 年 10 月 30 日 | 2.9.1 | - | - | - |