このページは Cloud Translation API によって翻訳されました。

ダウンロード可能なフォントを使用する

注: このページでは、View ベースの UI でダウンロード可能なフォントを使用する方法について説明します。Jetpack Compose を使用している場合は、Compose でのダウンロード可能フォントのドキュメントをご覧ください。

ダウンロード可能なフォント機能を使用すると、API は、ファイルをアプリにバンドルしたり、アプリにフォントをダウンロードさせたりする代わりに、プロバイダアプリにフォントをリクエストできます。ダウンロード可能フォントは、Android API バージョン 14 以降を搭載しているデバイスで、AndroidX Core ライブラリを通じて利用できます。

ダウンロード可能なフォントには次のようなメリットがあります。

アプリのサイズが小さくなるため、アプリのインストール成功率が高くなります。
複数のアプリがプロバイダを介して同じフォントを共有できるため、システム全体の健全性が向上する。これにより、ユーザーのモバイルデータ、スマートフォンのメモリ、ディスク容量を節約できます。このモデルでは、フォントは必要に応じてネットワーク経由で取得されます。

ダウンロード可能フォントの実践的な経験については、DownloadableFonts サンプルアプリをご覧ください。

ダウンロード可能なフォントの仕組み

フォントプロバイダは、フォントを取得してローカルにキャッシュし、他のアプリがフォントをリクエストして共有できるようにするアプリです。次の図は、このプロセスを示しています。

絵文字互換プロセスの主なコンポーネントを示す画像 — **図 1.** ダウンロード可能なフォントのプロセス

基本情報

ダウンロード可能なフォント機能は次の方法で使用できます。詳細については、後のセクションで説明します。

Android Studio と Google Play 開発者サービスを使用する
プログラムを介して使用する
AndroidX Core ライブラリを使用する

Android Studio と Google Play 開発者サービスでダウンロード可能フォントを使用する

Android Studio 3.0 以上を使用して、フォントをダウンロードするようにアプリを設定できます。ダウンロード可能フォント機能の使用を開始するには、Google Play 開発者サービスのフォントプロバイダを使用できます。

Layout Editor で TextView を選択します。次に、[Attributes] で、[fontFamily] > [More Fonts] を選択します。

図 2.Layout Editor を使用する。

[Resources] ウィンドウが表示されます。
[Source] メニューで、[Google Fonts] を選択します。
[フォント] ボックスの [ダウンロード可能] でフォントを選択します。
[Create downloadable font]（ダウンロード可能なフォントを作成）を選択して [OK] をクリックします。

図 3.[Resources] ウィンドウからのフォントの選択。

Android Studio は、アプリでフォントを正しくレンダリングするために必要な関連 XML ファイルを自動的に生成します。

フォントをプレビューする方法を示す画像 — **図 4.**フォントファイルをプレビューします。

ダウンロード可能なフォントをプログラムで使用する

Android 8.0（API レベル 26）以降、AndroidX Core ではダウンロード可能フォントが完全にサポートされています。AndroidX Core ライブラリの使用について詳しくは、このページのダウンロード可能フォント AndroidX Core ライブラリのセクションをご覧ください。

ダウンロード可能なフォント機能をプログラムで使用するには、次の 2 つの主要なクラスを操作します。

android.graphics.fonts.FontRequest: このクラスを使用すると、フォントリクエストを作成できます。
FontsContractCompat: このクラスを使用すると、フォントリクエストに基づいて新しい Typeface オブジェクトを作成できます。

アプリは、FontsContract API を使用して、フォントプロバイダからフォントを取得します。プロバイダごとに、サポートする Android のバージョンとクエリ言語に関する独自の制限があります。Android のバージョンとクエリ形式の詳細については、プロバイダのドキュメントをご覧ください。

フォントをダウンロードする手順は次のとおりです。

android.graphics.fonts.FontRequest クラスのインスタンスを作成して、プロバイダにフォントをリクエストします。リクエストを作成するには、次のパラメータを渡します。
- フォントプロバイダオーソリティ。
- プロバイダの ID を確認するためのフォントプロバイダパッケージ
- フォントの文字列クエリ。クエリ形式の詳細については、フォントプロバイダのドキュメント（Google Fonts など）をご覧ください。
- プロバイダの ID を確認するための証明書のハッシュのセット。
  注: プリインストールプロバイダのフォントをリクエストする場合、証明書を追加する必要はありません。ただし、AndroidX Core ライブラリからフォントをリクエストする場合は、必ず証明書を提供してください。
Kotlin
```
val request = FontRequest(
        "com.example.fontprovider.authority",
        "com.example.fontprovider",
        "my font",
        certs
)
```
Java
```
FontRequest request = new FontRequest("com.example.fontprovider",
                   "com.example.fontprovider", "my font", certs);
```
注: パラメータ値はフォントプロバイダから取得できます。Android Studio では、UI でサポートされているプロバイダのこれらの値が自動的に入力されます。
FontsContract.FontRequestCallback クラスのインスタンスを作成します。
onTypefaceRetrieved() メソッドをオーバーライドして、フォントリクエストが完了したことを示します。取得したフォントをパラメータとして指定します。このメソッドを使用すると、必要に応じてフォントを設定できます。たとえば、TextView でフォントを設定できます。
フォントのリクエストプロセスでのエラーに関する情報を受け取るように、onTypefaceRequestFailed() メソッドをオーバーライドします。エラーコードの詳細については、エラーコード定数をご覧ください。
FontsContract.requestFont() メソッドを呼び出して、フォントプロバイダからフォントを取得します。このメソッドは、フォントがキャッシュに存在するかどうかを判断するためのチェックを開始します。ローカルでフォントを使用できない場合は、フォントプロバイダを呼び出して非同期でフォントを取得し、結果をコールバックに渡します。次のパラメータを渡します。
- Context クラスのインスタンス
- android.graphics.fonts.FontRequest クラスのインスタンス
- フォントリクエストの結果を受け取るコールバック
- スレッドでフォントを取得するハンドラ

次のサンプルコードは、ダウンロード可能なフォントのプロセス全体を示しています。

Kotlin

val request = FontRequest(
        "com.example.fontprovider.authority",
        "com.example.fontprovider",
        "my font",
        certs
)
val callback = object : FontsContract.FontRequestCallback() {

    override fun onTypefaceRetrieved(typeface: Typeface) {
        // Your code to use the font goes here.
        ...
    }

    override fun onTypefaceRequestFailed(reason: Int) {
        // Your code to deal with the failure goes here.
        ...
    }
}
FontsContract.requestFonts(context, request, handler, null, callback)

Java

FontRequest request = new FontRequest("com.example.fontprovider.authority",
        "com.example.fontprovider", "my font", certs);
FontsContract.FontRequestCallback callback =
    new FontsContract.FontRequestCallback() {
        @Override
        public void onTypefaceRetrieved(Typeface typeface) {
            // Your code to use the font goes here.
            ...
        }

        @Override
        public void onTypefaceRequestFailed(int reason) {
            // Your code to deal with the failure goes here.
            ...
        }
};
FontsContract.requestFonts(context, request, handler, null, callback);

フォントプロバイダからフォントをダウンロードする方法の詳細については、DownloadableFonts サンプルアプリをご覧ください。

AndroidX Core でダウンロード可能フォントを使用する

AndroidX Core は、Android API バージョン 14 以上を搭載したデバイスでダウンロード可能なフォント機能をサポートしています。androidx.core.provider パッケージには、下位互換性のあるダウンロード可能なフォント機能のサポートを実装するための FontsContractCompat クラスと FontRequest クラスが含まれています。AndroidX クラスには、フレームワークメソッドに似たメソッドが含まれており、フォントをダウンロードするプロセスは、このページのプログラムでダウンロード可能フォントを使用するセクションで説明されているプロセスとほぼ同じです。

AndroidX を使用してフォントをダウンロードするには、FontsContractCompat クラスと FontRequest クラスを androidx.core.provider パッケージからインポートします。FontsContract および android.graphics.fonts.FontRequest フレームワーククラスの代わりに、これらのクラスのインスタンスを作成します。

AndroidX Core の依存関係を追加する

FontsContractCompat クラスと FontRequest クラスを使用するには、開発環境内でアプリプロジェクトのクラスパスの依存関係を変更する必要があります。

アプリプロジェクトに AndroidX Core を追加するには、アプリの build.gradle ファイルに次の依存関係を追加します。

Groovy

dependencies {
    ...
    implementation "androidx.core:core-ktx:2.2.0"
}

Kotlin

dependencies {
    ...
    implementation("androidx.core:core-ktx:2.2.0")
}

ダウンロード可能フォントを XML のリソースとして使用する

Android 8.0（API レベル 26）と AndroidX Core では、カスタムフォントを XML レイアウトのリソースとして迅速かつ簡単に宣言できます。つまり、フォントをアセットとしてバンドルする必要はありません。テーマ全体のカスタムフォントを定義すると、太字、中程度、明色など複数の太さやスタイル（提供されている場合）のユーザビリティが向上します。

res/font フォルダに新しい XML ファイルを作成します。
次のサンプル XML ファイルに示すように、<font-family> ルート要素を追加して、フォント関連の属性を設定します。

<?xml version="1.0" encoding="utf-8"?>
<font-family xmlns:android="http://schemas.android.com/apk/res/android"
        android:fontProviderAuthority="com.example.fontprovider.authority"
        android:fontProviderPackage="com.example.fontprovider"
        android:fontProviderQuery="example font"
        android:fontProviderCerts="@array/certs">
</font-family>

このファイルをレイアウト XML ファイルで @font/font_file_name として参照します。また、getFont() メソッドを使用してプログラムでファイルを取得することもできます（getFont(R.font.font_file_name) など）。

マニフェストでフォントを事前に宣言する

レイアウトのインフレーションとリソースの取得は同期タスクです。デフォルトでは、最初にフォントを取得しようとすると、フォントプロバイダへのリクエストがトリガーされるため、最初のレイアウト時間が長くなります。遅延を回避するには、取得する必要があるフォントをマニフェストで事前に宣言します。システムがプロバイダからフォントを取得すると、すぐに使用できるようになります。フォントの取得に想定よりも時間がかかる場合、システムは取得プロセスを中止し、デフォルトのフォントを使用します。

マニフェストでフォントを事前に宣言する手順は次のとおりです。

res/values/arrays.xml にリソース配列を作成し、プリフェッチするフォントを宣言します。

res/values/arrays.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <array name="preloaded_fonts">
        <item>@font/font1</item>
        <item>@font/font2</item>
    </array>
</resources>

マニフェストでリソース配列を宣言するには、meta-data タグを使用します。

<meta-data android:name="preloaded_fonts" android:resource="@array/preloaded_fonts" />

証明書を追加

フォントプロバイダがプリインストールされていない場合、または AndroidX Core ライブラリを使用している場合は、フォントプロバイダが署名している証明書を宣言します。システムは証明書を使用して、フォントプロバイダの ID を検証します。

証明書を追加するには、次の手順に従います。

証明書の詳細を含む文字列配列を作成します。証明書の詳細については、フォントプロバイダのドキュメントをご覧ください。

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array name="certs">
       <item>MIIEqDCCA5CgAwIBAgIJA071MA0GCSqGSIb3DQEBBAUAMIGUMQsww...</item>
    </string-array>
</resources>

fontProviderCerts 属性を配列に設定します。

android:fontProviderCerts="@array/certs"

Compose でのダウンロード可能フォント

Compose 1.2-alpha07 以降では、Compose アプリで Downloadable Fonts API を使用して Google Fonts を非同期でダウンロードしてアプリで使用できます。詳細については、Compose のダウンロード可能なフォントのドキュメントをご覧ください。