注: Android 9.0(API レベル 28)のリリース以降、Jetpack の一部として AndroidX という新しいバージョンのサポート ライブラリが導入されました。AndroidX ライブラリには既存のサポート ライブラリのほか、最新の Jetpack コンポーネントも含まれています。
サポート ライブラリは引き続きご利用いただけます。過去のアーティファクト(バージョン 27 以前で android.support.*
としてパッケージ化されたもの)は、Google Maven で引き続き利用できます。ただし、新しいライブラリ開発はすべて AndroidX ライブラリ内で行うことになります。
すべての新しいプロジェクトに AndroidX ライブラリを使用することをおすすめします。また、既存のプロジェクトを AndroidX に移行することもご検討ください。
開発プロジェクトで Android Support Library を設定する方法は、機能によって異なる サポートする Android プラットフォームのバージョンの範囲を 説明します。
このドキュメントでは、サポート ライブラリ パッケージのダウンロードとライブラリの追加について説明します。 開発環境にデプロイできます。
サポート ライブラリは、Google の Maven リポジトリから入手できるようになりました。SDK を使用したライブラリのダウンロードはサポートされなくなりました この機能はまもなく削除されます。
サポート ライブラリの選択
アプリにサポート ライブラリを追加する前に、含める機能を決定する サポートする最小の Android バージョンこれらの機能について詳しくは については、以下をご覧ください。 サポート ライブラリの機能。
Support Library の追加
サポート ライブラリを使用するには、アプリケーションのプロジェクトの クラスパスの依存関係を宣言します。使用する Support Library ごとにこの手順を実行します。
アプリのプロジェクトにサポート ライブラリを追加するには:
- Google の Maven リポジトリをプロジェクトの
settings.gradle
ファイルに含めます。dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() // If you're using a version of Gradle lower than 4.1, you must // instead use: // // maven { // url 'https://maven.google.com' // } } }
- サポート ライブラリを使用するモジュールごとに、
モジュールの
build.gradle
ファイルのdependencies
ブロックです。対象 たとえば、v4 core-utils ライブラリを追加するには、以下を追加します。dependencies { ... implementation "com.android.support:support-core-utils:28.0.0" }
注意: 動的な依存関係(
palette-v7:23.0.+
)が原因で予期しないバージョン アップデートが発生し、
回帰の非互換性ライブラリのバージョン(palette-v7:28.0.0
など)を明示的に指定することをおすすめします。
Support Library API の使用
既存のフレームワーク API をサポートするサポート ライブラリ クラスには、通常、
フレームワーク クラスと同じ名前ですが、android.support
クラス パッケージにあります。
*Compat
という接尾辞を付けます。
注意: サポート ライブラリのクラスを使用する場合は、
クラスから適切なパッケージを取得してください。たとえば、ActionBar
を適用するときは、
class:
- サポート ライブラリを使用する場合:
android.support.v7.app.ActionBar
- API レベル 11 以降だけを対象に開発する場合:
android.app.ActionBar
注: サポート ライブラリをアプリ プロジェクトに組み込んだ後は、リリースに向けて、アプリを圧縮、難読化、最適化することを強くおすすめします。難読化でソースコードを保護するだけでなく、 アプリケーションに含めたすべてのライブラリから使用されていないクラスが削除され、 アプリケーションのダウンロード サイズをできる限り小さくする必要があります。
サポート ライブラリ機能の使用方法については、Android デベロッパーのトレーニング クラス、ガイド、サンプルをご覧ください。サポート ライブラリの個々のクラスとメソッドの詳細については、
API リファレンスの android.support
パッケージ。
マニフェストの宣言の変更
既存のアプリケーションの下位互換性を以前のアプリケーション
Android API のバージョンを Support Library とともに使用している場合は、アプリケーションの
使用します。具体的には、android:minSdkVersion
を更新します。
の要素
マニフェストの <uses-sdk>
タグを新しい下位のバージョン番号に置き換えます。
下に示します。
<uses-sdk android:minSdkVersion="14" android:targetSdkVersion="23" />
マニフェスト設定により、Android を搭載したデバイスにアプリをインストールできることを Google Play に知らせます。 4.0(API レベル 14)以降。
Gradle ビルドファイルを使用している場合、マニフェストの設定よりもビルドファイル内の minSdkVersion
の設定が優先されます。
plugins { id 'com.android.application' } android { ... defaultConfig { minSdkVersion 16 ... } ... }
この例では、ビルドファイルの設定により、アプリのデフォルトのビルド バリアントが アプリは、Android 4.1(API レベル 16)以上を搭載したデバイスにインストールできます。詳細情報 ビルド バリアントについて詳しくは、以下をご覧ください。 ビルドシステムの概要。
注: 複数のサポート ライブラリを追加している場合、 最小 SDK バージョンは、以下のいずれかで必須とされる最新バージョンである必要があります ダウンロードします。たとえば、v14 preference サポート ライブラリと v17 Leanback ライブラリの両方をアプリに組み込んでいる場合は、最小 SDK バージョンを 17 以上にする必要があります。