サポート ライブラリ パッケージ

注: サポート ライブラリ 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 ライブラリ

AsyncTaskLoaderPermissionChecker など、さまざまなユーティリティ クラスを提供します。

このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。

com.android.support:support-core-utils:28.0.0

v4 core-ui ライブラリ

ViewPagerNestedScrollViewExploreByTouchHelper など、さまざまな UI 関連コンポーネントを実装します。

このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。

com.android.support:support-core-ui:28.0.0

v4 media-compat ライブラリ

MediaBrowserMediaSession など、メディア フレームワークの部分をバックポートします。

このライブラリの Gradle ビルド スクリプト依存関係識別子は次のとおりです。

com.android.support:support-media-compat:28.0.0

v4 fragment ライブラリ

フラグメントによるユーザー インターフェースと機能のカプセル化のサポートが追加されます。これにより、アプリは小画面のデバイスと大画面デバイスの間で調整できるレイアウトを提供できます。このモジュールは、compatcore-utilscore-uimedia-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 ライブラリ

このライブラリは、MediaRouterMediaRouteProvider、および 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 設定を変更するための環境設定オブジェクト(CheckBoxPreferenceListPreference など)の追加をサポートする API が用意されています。

v7 Preference ライブラリは、Preference.OnPreferenceChangeListenerPreference.OnPreferenceClickListener などのインターフェースと、CheckBoxPreferenceListPreference などのクラスのサポートを追加します。

このライブラリの 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.OnPreferenceStartFragmentCallbackPreferenceFragment.OnPreferenceStartScreenCallback などの設定インターフェースと、MultiSelectListPreferencePreferenceFragment などのクラスのサポートを追加する 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 が用意されています。これには、BaseLeanbackPreferenceFragmentLeanbackPreferenceFragment などの 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 アプリ向けに、さまざまな重要ウィジェットを実現できます。主なクラスは次のとおりです。

このパッケージには 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