Jetpack ライブラリは Android OS とは別にリリースされるため、ライブラリの更新は独立して頻繁に行われます。
ライブラリは、厳格なセマンティック バージョニングに従って、リリース前リビジョンの追加のバージョン間シーケンスとのバイナリ互換性を維持します。バージョン文字列(1.0.1-beta02
など)には、メジャー、マイナー、バグフィックスの各レベルを表す 3 つの数値が含まれます。リリース前のバージョンにも、リリース前の段階(アルファ版、ベータ版、リリース候補版)とリビジョン番号(01、02 など)を指定するサフィックスがあります。
注: マイナー バージョン間でのソースの互換性を維持するには、androidx
ライブラリの使用が推奨されますが、必須ではありません。メジャー バージョンの更新に伴い、以前のメジャー バージョンに依存するすべてのアーティファクトが明示的に移行され、デベロッパーのワークフローが中断されるためです。
ライブラリの各バージョンはリリース前の 3 つの段階を経て安定版になります。リリース前の各段階の基準は次のとおりです。
アルファ版
- アルファ版リリースは機能的に安定していますが、機能が完成していないことがあります。
- リリースがアルファ版の間は、API が追加、削除、変更されることがあります。
ベータ版
- ベータ版リリースは機能的に安定しており、機能の完成した API サーフェスを備えています。
- 製品版となる準備ができていますが、バグが存在する可能性があります。
- ベータ版リリースでは、試験運用版コンパイラの機能(
@UseExperimental
など)は利用できません。 - 他のライブラリへの依存関係は、ベータ版、RC 版、または安定版であることが必要です。アルファ版の依存関係は許可されません。
リリース候補(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 など)では、複数のアーティファクトが個別に管理されています。それらのライブラリにはアスタリスク(*)が付いています。すべてのアーティファクトのバージョン アップデートを確認するには、リリースノートをご覧ください。