Jetpack 程式庫與 Android 作業系統會分開發布,因此程式庫的更新能夠獨立且更頻繁地推出。
程式庫遵循嚴格的語義版本管理,可維持與預先發布版修訂版本新增版本序列的二進位檔相容性。版本字串 (例如 1.0.1-beta02
) 包含三個數字,代表主要、次要和錯誤修正等級。預先發布版還包含後置字串,用於指定預先發布階段 (Alpha 版、Beta 版、候選版) 和修訂版本編號 (01、02 等)。
請注意,我們希望 (但非強制性) androidx
程式庫能維持子版本間的原始碼相容性。如要發布主要版本更新,系統會強制依附於先前主要版本的所有構件執行明確遷移,這項作業會中斷開發人員的工作流程。
每個程式庫版本都會經歷三個預先發布階段,才會發展成穩定版。每個預先發布階段的資格條件如下:
Alpha 版
- Alpha 版功能穩定,但功能可能不完整。
- 版本處於 Alpha 版時,可能會新增、移除或變更 API。
Beta 版
- Beta 版的功能穩定,且提供功能完整的 API 介面。
- 這類 API 可用於實際工作環境,但可能包含錯誤。
- Beta 版無法使用實驗性編譯器功能 (例如
@UseExperimental
)。 - 依附其他程式庫的依附元件必須是 Beta 版、rc 版或穩定版。不允許任何 Alpha 依附元件。
候選版 (RC)
- 候選版本是潛在的穩定版本。
- 可能包含重大的最後修正項目。
- 其 API 介面為最終版本。
- 依附其他程式庫的依附元件僅限候選版本或穩定版。
程式庫可以同時擁有多個版本。每個版本都有不同的發布階段。舉例來說,androidx.activity
的穩定版可能是 1.0.0
,但可能另有 1.1.0-beta02
版和 2.0.0-alpha01
版。
本頁內容將說明程式庫的最新更新內容。
AndroidX 近期版本資訊頁面列有最近更新過的程式庫。Google 的 Maven 存放區會顯示完整的版本記錄。
請參閱下表,查看每個 AndroidX 程式庫的最新穩定版本和預先發布版。您可以透過每列的連結前往程式庫的版本資訊。版本資訊中提供的內容如下:
- 所有版本依時間順序的發布記錄。
- 具備預設 Gradle 依附元件宣告的程式碼片段,可用來使用構件。
- 每個構件中套件的 Kotlin 和 Java 參考資料頁面連結。
Jetpack 程式庫
部分 AndroidX 程式庫 (例如 camera) 有多個獨立維護的構件。這些程式庫會以星號 (*) 標示。請參閱版本資訊,查看所有構件的版本更新。