注: サポート ライブラリ 28.0.0 のリリースに伴い、android.support
にパッケージ化されたライブラリは非推奨になり、androidx
としてパッケージ化された、個別にバージョニングされる Jetpack ライブラリに置き換わります。Jetpack ライブラリの最初の 1.0.0 リリースは、サポート ライブラリ 28.0.0 と同等の機能を提供し、新しい androidx
パッケージに移行するための出発点を提供します。
既存の android.support
パッケージ ライブラリは引き続き機能しますが、28.0.0 以降のアップデートは受信されず、新しい Jetpack ライブラリと互換性がありません。
過去のアーティファクト(バージョン 27 以前で、android.support
としてパッケージ化されたもの)は、Google Maven で引き続き利用できます。新しいアーティファクトはすべて androidx
としてパッケージ化され、android.support
から androidx
への移行が必要になります。
すべての新しいプロジェクトで、androidx
ライブラリを使用することをおすすめします。また、バグ修正やその他のライブラリの改善が引き続き適用されるよう、既存のプロジェクトの移行も検討してください。
Android サポート ライブラリには、アプリに含めることができる複数のライブラリ パッケージが含まれています。各ライブラリは、特定の範囲の Android プラットフォーム バージョンと機能セットをサポートしています。
以下のライブラリを使用するには、ライブラリ ファイルを Android SDK インストールにダウンロードする必要があります。サポート ライブラリのセットアップに記載されているサポート ライブラリのダウンロード手順に沿って、このステップを完了します。特定のサポート ライブラリをアプリに含めるには、追加の手順を行う必要があります。ライブラリをアプリに含める方法に関する重要な情報については、以下の各ライブラリ セクションの最後をご覧ください。
注: すべてのサポート ライブラリ パッケージの最小 SDK バージョンは、API レベル 14 以降です。以下で説明するように、一部のパッケージではより高い API レベルが必要です。
v4 サポート ライブラリ
これらのライブラリには、アプリ コンポーネント、ユーザー インターフェース機能、ユーザー補助、データ処理、ネットワーク接続、プログラミング ユーティリティのサポートなど、他のライブラリと比較して最大の API セットが含まれています。
v4 サポート ライブラリで提供されるクラスとメソッドについて詳しくは、API リファレンスの android.support.v4
パッケージをご覧ください。
注: サポート ライブラリのリビジョン 24.2.0 より前は、v4 サポート ライブラリは 1 つでした。効率を高めるために、このライブラリは複数のモジュールに分割されました。下位互換性を確保するため、Gradle スクリプトで support-v4
を指定すると、すべての v4 モジュールがアプリに含まれます。ただし、アプリのサイズを小さくするには、アプリに必要な特定のモジュールのみを記述することをおすすめします。
v4 compat ライブラリ
Context.obtainDrawable()
や View.performAccessibilityAction()
など、さまざまなフレームワーク API の互換性ラッパーを提供します。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:support-compat:28.0.0
v4 core-utils ライブラリ
AsyncTaskLoader
や PermissionChecker
など、さまざまなユーティリティ クラスを提供します。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:support-core-utils:28.0.0
v4 core-ui ライブラリ
ViewPager
、NestedScrollView
、ExploreByTouchHelper
など、さまざまな UI 関連コンポーネントを実装します。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:support-core-ui:28.0.0
v4 media-compat ライブラリ
MediaBrowser
や MediaSession
など、メディア フレームワークの部分をバックポートします。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:support-media-compat:28.0.0
v4 fragment ライブラリ
フラグメントによるユーザー インターフェースと機能のカプセル化のサポートが追加されます。これにより、アプリは小画面のデバイスと大画面デバイスの間で調整できるレイアウトを提供できます。このモジュールは、compat、core-utils、core-ui、media-compat に依存しています。
注: v13 サポート ライブラリには FragmentCompat
クラスが用意されています。v4 の Fragment
クラスは、今後のプラットフォーム バージョンで追加されたバグ修正を提供するスタンドアロン クラスです。一方、v13 の FragmentCompat
クラスは、Fragment
クラスのフレームワーク実装用の互換性 shim を提供します。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:support-fragment:28.0.0
multidex サポート ライブラリ
このライブラリは、複数の Dalvik Executable(DEX)ファイルを使用したアプリのビルドをサポートします。65,536 を超えるメソッドを参照するアプリでは、multidex 構成を使用する必要があります。Multidex の使用について詳しくは、 64K を超えるメソッドを使用したアプリの構築をご覧ください。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:multidex:1.0.0
v7 サポート ライブラリ
これらのライブラリは特定の機能セットを提供し、互いに独立してアプリに組み込めます。
v7 appcompat ライブラリ Android Jetpack の一部。
注: appcompat ライブラリは、Android Jetpack コンポーネントである AndroidX ライブラリに移行しました。Sunflower デモアプリで使用例をご覧ください。
このライブラリは、アクションバー ユーザー インターフェースのデザイン パターンのサポートを追加します。このライブラリには、マテリアル デザインのユーザー インターフェース実装のサポートが含まれています。
注: このライブラリは、v4 サポート ライブラリに依存します。
v7 appcompat ライブラリに含まれる主なクラスは次のとおりです。
ActionBar
- アクションバーのユーザー インターフェース パターンを実装します。アクションバーの使用方法については、アクションバー デベロッパー ガイドをご覧ください。AppCompatActivity
- サポート ライブラリのアクションバー実装を使用するアクティビティの基本クラスとして使用できるアプリ アクティビティ クラスを追加します。AppCompatDialog
- AppCompat テーマのダイアログの基本クラスとして使用できるダイアログ クラスを追加します。ShareActionProvider
- アクションバーに含めることができる、標準化された共有操作(メールやソーシャル アプリケーションへの投稿など)のサポートを追加します。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:appcompat-v7:28.0.0
v7 cardview ライブラリ
このライブラリは、CardView
ウィジェットのサポートを追加します。これにより、どのアプリでも一貫したデザインのカード内に情報を表示できます。これらのカードはマテリアル デザインの実装に役立ち、TV アプリのレイアウトで広く使用されています。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:cardview-v7:28.0.0
v7 gridlayout ライブラリ
Android サポート ライブラリをダウンロードすると、このライブラリは GridLayout
クラスのサポートを追加します。これにより、長方形のセルのグリッドを使用してユーザー インターフェース要素を配置できます。v7 gridlayout ライブラリの API について詳しくは、API リファレンスの android.support.v7.widget
パッケージをご覧ください。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:gridlayout-v7:28.0.0
v7 mediarouter ライブラリ
このライブラリは、MediaRouter
、MediaRouteProvider
、および Google Cast をサポートする関連するメディアクラスを提供します。
一般に、v7 mediarouter ライブラリの API は、現在のデバイスから外部の画面、スピーカー、その他の宛先デバイスへのメディア チャンネルとストリームのルーティングを制御する手段を提供します。このライブラリには、アプリ固有のメディアルート プロバイダの公開、宛先デバイスの検出と選択、メディア ステータスの確認などを行うための API が含まれています。v7 mediarouter ライブラリの API について詳しくは、API リファレンスの android.support.v7.media
パッケージをご覧ください。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:mediarouter-v7:28.0.0
サポート ライブラリ r18 で導入された v7 mediarouter ライブラリの API は、サポート ライブラリの今後のリビジョンで変更される可能性があります。現時点では、このライブラリは Google Cast との接続でのみ使用することをおすすめします。
v7 palette ライブラリ
v7 Palette のサポート ライブラリには、画像から目立つ色を抽出できる Palette
クラスが含まれています。たとえば、音楽アプリでは Palette
オブジェクトを使用してアルバムカバーから主な色を抽出し、その色を使用して色分けされた曲のタイトルカードを作成できます。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:palette-v7:28.0.0
v7 recyclerview ライブラリ
recyclerview ライブラリは RecyclerView
クラスを追加します。このクラスは RecyclerView ウィジェットをサポートします。このウィジェットは、データアイテムの限られたウィンドウを提供することで、大規模なデータセットを効率的に表示するためのビューです。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:recyclerview-v7:28.0.0
v7 preference サポート ライブラリ
preference パッケージには、ユーザーが UI 設定を変更するための環境設定オブジェクト(CheckBoxPreference
や ListPreference
など)の追加をサポートする API が用意されています。
v7 Preference ライブラリは、Preference.OnPreferenceChangeListener
や Preference.OnPreferenceClickListener
などのインターフェースと、CheckBoxPreference
や ListPreference
などのクラスのサポートを追加します。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:preference-v7:28.0.0
v8 サポート ライブラリ
このライブラリは特定の機能セットを提供し、他のライブラリから独立してアプリに組み込めます。
v8 renderscript ライブラリ
このライブラリは、RenderScript 計算フレームワークのサポートを追加します。これらの API は android.support.v8.renderscript
パッケージに含まれています。これらの API をアプリに組み込む手順は、他のサポート ライブラリ API とは大きく異なることに留意する必要があります。アプリケーションでこれらの API を使用する方法について詳しくは、RenderScript デベロッパー ガイドをご覧ください。
注: サポート ライブラリがある RenderScript は、Android Studio と Gradle ベースのビルドで使用できます。renderscript ライブラリは、build-tools/$VERSION/renderscript/
フォルダにあります。
このライブラリの Gradle ビルド スクリプト プロパティの例を以下に示します。
defaultConfig { renderscriptTargetApi 18 renderscriptSupportModeEnabled true }
v13 サポート ライブラリ
このライブラリは、Fragment ユーザー インターフェース パターンのサポートを(FragmentCompat
)クラスと追加のフラグメント サポートクラスで追加します。フラグメントの詳細については、フラグメントのデベロッパー ガイドをご覧ください。v13 サポート ライブラリ API の詳細については、API リファレンスの android.support.v13
パッケージをご覧ください。
注: v4 Fragment ライブラリには、Fragment
クラスが用意されています。v4 の Fragment
クラスは、今後のプラットフォーム バージョンで追加されたバグ修正を提供するスタンドアロン クラスです。一方、v13 の FragmentCompat
クラスは、Fragment
クラスのフレームワーク実装用の互換性 shim を提供します。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:support-v13:28.0.0
v14 preference サポート ライブラリ
android.support.v14.preference
パッケージには、PreferenceFragment.OnPreferenceStartFragmentCallback
や PreferenceFragment.OnPreferenceStartScreenCallback
などの設定インターフェースと、MultiSelectListPreference
や PreferenceFragment
などのクラスのサポートを追加する API が用意されています。v14 Preference Support Library API の詳細については、API リファレンスの preference パッケージをご覧ください。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:preference-v14:28.0.0
v17 TV 用 preference サポート ライブラリ
android.support.v17.preference
パッケージには、TV デバイスに設定インターフェースを提供するための API が用意されています。これには、BaseLeanbackPreferenceFragment
や LeanbackPreferenceFragment
などの LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener
インターフェースとクラスのサポートが含まれます。v17 Preference Support Library の API について詳しくは、API リファレンスの preference パッケージをご覧ください。
このパッケージには API レベル 17 以降が必要です。このライブラリの Gradle ビルド スクリプトの依存関係 ID は次のとおりです。
com.android.support:preference-leanback-v17:28.0.0
v17 Leanback ライブラリ
android.support.v17.leanback
パッケージには、TV デバイスでのユーザー インターフェースの作成をサポートする API が用意されています。このライブラリにより、TV アプリ向けに、さまざまな重要ウィジェットを実現できます。主なクラスは次のとおりです。
BrowseFragment
- ブラウジング カテゴリとメディア アイテムの行用のプライマリ レイアウトを作成するためのフラグメント。DetailsFragment
- Leanback 詳細画面のラッパー フラグメント。PlaybackOverlayFragment
- 再生コントロールと関連コンテンツを表示するためのDetailsFragment
のサブクラス。SearchFragment
- 検索を処理するフラグメント。このフラグメントは、ユーザーの検索リクエストを受け取り、アプリが提供するSearchResultProvider
に渡します。SearchResultProvider
は検索結果をSearchFragment
に返し、RowsFragment
にレンダリングします。
このパッケージには API レベル 17 以降が必要です。このライブラリの Gradle ビルド スクリプトの依存関係 ID は次のとおりです。
com.android.support:leanback-v17:28.0.0
vector drawable ライブラリ
静的ベクター グラフィックをサポートします。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:support-vector-drawable:28.0.0
animated vector drawable ライブラリ
アニメーション ベクター グラフィックをサポートします。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:animated-vector-drawable:28.0.0
annotations サポート ライブラリ
Annotation パッケージには、アプリにアノテーション メタデータを追加するための API が用意されています。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:support-annotations:28.0.0
design サポート ライブラリ
Design パッケージには、マテリアル デザインのコンポーネントとパターンをアプリに追加するための API が用意されています。
デザイン サポート ライブラリは、ナビゲーション ドロワー、フローティング アクション ボタン(FAB)、スナックバー、タブなど、アプリ デベロッパーが開発のベースとなるさまざまなマテリアル デザイン コンポーネントとパターンのサポートを追加します。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:design:28.0.0
custom tabs サポート ライブラリ
Custom Tabs パッケージには、アプリでのカスタムタブの追加と管理をサポートする API が用意されています。
カスタムタブ サポート ライブラリは、カスタムタブ サービスやカスタムタブ コールバックなど、さまざまなクラスのサポートを追加します。
このパッケージには API レベル 15 以降が必要です。 このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:customtabs:28.0.0
percent サポート ライブラリ
Percent パッケージには、アプリでの割合ベースのディメンションの追加と管理をサポートする API が用意されています。
注: リリース 26.0.0 で、Percent サポート ライブラリは非推奨になりました。このモジュールのクライアントは、SDK Manager で個別のアーティファクトとして提供されている新しい ConstraintLayout
ウィジェットに移行する必要があります。
Percent サポート ライブラリにより、 PercentLayoutHelper.PercentLayoutParams インターフェースと、PercentFrameLayout や PercentRelativeLayout などのさまざまなクラスのサポートが追加されます。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:percent:28.0.0
ExifInterface サポート ライブラリ
Exif タグは、画面の向き、日時、カメラ情報、撮影場所などの情報を JPEG または RAW ファイルに直接保存します。ExifInterface
クラスは、JPEG および未加工(DNG、CR2、NEF、NRW、ARW、RW2、ORF、PEF、SRW、RAF)形式のファイルから Exif 情報を読み取り、JPEG 画像ファイルに Exif 情報を設定するためのサポートを分離します。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:exifinterface:28.0.0
TV 用 app recommendation サポート ライブラリ
App Recommendation パッケージには、TV デバイスで実行されるアプリにおすすめコンテンツを追加するための API が用意されています。
アプリ ライブラリは、 ContentRecommendation.ContentMaturity などのアノテーションや、ContentRecommendation や RecommendationExtender などのさまざまなクラスのサポートを追加します。
このパッケージには API レベル 21 以降が必要です。 このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:recommendation:28.0.0
Wear UI ライブラリ
このライブラリには、Wear アプリのユーザー インターフェースを作成するための API があります。 android.support.wear.widget パッケージに含まれる API は、ウェアラブル サポート ライブラリの対応する API に代わるものです。
詳細については、 Wear UI ライブラリの使用をご覧ください。
このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。
com.android.support:wear:28.0.0