ダウンロード可能フォント機能を使用すると、API はプロバイダ アプリからフォントをリクエストできます。この場合、アプリにファイルをバンドルしたり、アプリがフォントをダウンロードしたりする必要はありません。ダウンロード可能なフォントは、Android API バージョン 14 以降を搭載したデバイスで、AndroidX Core ライブラリを介して利用できます。
ダウンロード可能なフォントには次のようなメリットがあります。
- アプリのサイズが小さくなるため、アプリのインストール成功率が向上します。
- 複数のアプリがプロバイダを介して同じフォントを共有できるため、システム全体の健全性が改善されます。これにより、ユーザーのモバイルデータ、スマートフォンのメモリ、ディスク容量を節約できます。このモデルでは、フォントは必要に応じてネットワーク経由でフェッチされます。
ダウンロード可能なフォントの仕組み
フォント プロバイダとは、フォントを取得してローカルにキャッシュし、他のアプリがフォントをリクエストして共有できるようにするアプリのことです。次の図は、このプロセスを示しています。
基本情報
ダウンロード可能なフォント機能は、次の方法で使用できます。詳細については、後のセクションで説明します。
Android Studio や Google Play 開発者サービスでダウンロード可能なフォントを使用する
Android Studio 3.0 以降を使用すると、アプリでフォントをダウンロードするように設定できます。Google Play 開発者サービスのフォント プロバイダを使用すると、ダウンロード可能フォント機能を簡単に使用できます。
- Layout Editor で
TextView
を選択します。次に、[属性] で [fontFamily] > [その他のフォント] を選択します。 [Resources] ウィンドウが表示されます。 - [ソース] メニューで [Google Fonts] を選択します。
- [フォント] ボックスの [ダウンロード可能] 領域でフォントを選択します。
- [Create downloadable font] を選択して [OK] をクリックします。
Android Studio は、アプリでフォントを正しくレンダリングするために必要な関連 XML ファイルを自動的に生成します。
プログラムでダウンロード可能フォントを使用する
Android 8.0(API レベル 26)以降、AndroidX Core はダウンロード可能フォントを完全にサポートしています。AndroidX Core ライブラリの使用方法については、このページのダウンロード可能フォントの AndroidX コアライブラリのセクションをご覧ください。
「ダウンロード可能フォント」機能をプログラムで使用するには、次の 2 つの主要なクラスを操作します。
android.graphics.fonts.FontRequest
: このクラスを使用すると、フォント リクエストを作成できます。FontsContractCompat
: このクラスを使用すると、フォント リクエストに基づいて新しいTypeface
オブジェクトを作成できます。
アプリは、FontsContract
API を使用してフォント プロバイダからフォントを取得します。プロバイダごとに、サポートされる Android のバージョンとクエリ言語に関する独自の制限があります。Android のバージョンとクエリ形式の詳細については、プロバイダのドキュメントをご覧ください。
フォントをダウンロードする手順は次のとおりです。
android.graphics.fonts.FontRequest
クラスのインスタンスを作成して、プロバイダにフォントをリクエストします。リクエストを作成するには、次のパラメータを渡します。- フォント プロバイダ オーソリティ。
- プロバイダの ID を確認するためのフォント プロバイダ パッケージ
- フォントの文字列クエリ。クエリ形式の詳細については、フォント プロバイダのドキュメント(Google Fonts など)をご覧ください。
- プロバイダの ID を確認するための証明書のハッシュセットのリスト。
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);
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 を使用してフォントをダウンロードするには、androidx.core.provider
パッケージから FontsContractCompat
クラスと FontRequest
クラスをインポートします。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 ファイルで
@font/font_file_name
としてファイルを参照します。getFont()
メソッドを使用して、getFont(R.font.font_file_name)
などのプログラムでファイルを取得することもできます。
<?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>
マニフェストでフォントを事前に宣言する
レイアウトのインフレーションとリソースの取得は同期タスクです。デフォルトでは、最初にフォントを取得しようとすると、フォント プロバイダへのリクエストがトリガーされるため、最初のレイアウト時間が長くなります。この遅延を回避するには、取得する必要があるフォントをマニフェストで事前に宣言します。フォントがプロバイダから取得されると、すぐに使用できるようになります。フォントの取得に予想よりも時間がかかる場合、システムは取得プロセスを中止し、デフォルトのフォントを使用します。
マニフェストでフォントを事前に宣言する手順は次のとおりです。
res/values/arrays.xml
にリソース配列を作成し、プリフェッチするフォントを宣言します。meta-data
タグを使用して、マニフェストでリソース配列を宣言します。
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 android:name="preloaded_fonts" android:resource="@array/preloaded_fonts" />
証明書を追加
フォント プロバイダがプリインストールされていない場合、または AndroidX Core ライブラリを使用している場合は、フォント プロバイダが署名する証明書を宣言します。システムは証明書を使用してフォント プロバイダの ID を検証します。
証明書を追加するには、次の手順に従います。
- 証明書の詳細を含む文字列配列を作成します。証明書の詳細については、フォント プロバイダのドキュメントをご覧ください。
fontProviderCerts
属性を配列に設定します。
<?xml version="1.0" encoding="utf-8"?> <resources> <string-array name="certs"> <item>MIIEqDCCA5CgAwIBAgIJA071MA0GCSqGSIb3DQEBBAUAMIGUMQsww...</item> </string-array> </resources>
android:fontProviderCerts="@array/certs"
Compose のダウンロード可能なフォント
Compose 1.2-alpha07 以降では、Compose アプリで Downloadable Fonts API を使用して、Google Fonts を非同期でダウンロードしてアプリで使用できます。詳細については、Compose のダウンロード可能なフォントのドキュメントをご覧ください。