本頁面由 Cloud Translation API 翻譯而成。

使用可下載字型

可下載的字型功能可讓 API 向供應程式應用程式要求字型，而不是將檔案附加到應用程式中，或是讓應用程式下載字型。可下載字型可透過 AndroidX Core 程式庫，在搭載 Android API 14 以上版本的裝置上使用。

可下載字型具備下列優點：

縮減應用程式的大小，進而提高應用程式的安裝成功率。
改善系統的整體健康情況，因為多個應用程式可以透過一個供應程式共用相同字型。這樣可以節省使用者的行動數據、手機記憶體和磁碟空間。在這個模式中，系統會在需要時透過網路擷取字型。

如要實際體驗可下載字型，請參閱 DownloadableFonts 範例應用程式。

可下載字型功能如何運作？

字型提供者應用程式可擷取字型並在本機快取，讓其他應用程式可以要求及分享字型。下圖說明此程序。

基本概念

您可以透過下列方式使用可下載字型功能，我們將在後續章節中詳細說明：

使用 Android Studio 和 Google Play 服務
透過程式輔助方式
使用 AndroidX Core 程式庫

搭配 Android Studio 和 Google Play 服務使用可下載字型

您可以將應用程式設定為使用 Android Studio 3.0 以上版本下載字型。為了協助您開始使用可下載字型功能，您可以使用 Google Play 服務的字型供應程式。

在「Layout Editor」中，選取 TextView。然後在「Attributes」下方，依序選取「fontFamily」>「More Fonts」。

圖 2. 使用版面配置編輯器。

「Resources」視窗隨即顯示。
在「Source」選單中，選取「Google 字型」。
在「字型」方塊中的「可下載」區域下方選取字型。
選取「Create download font」，然後按一下「OK」。

圖 3. 從「Resources」視窗中選取字型。

Android Studio 會自動產生在應用程式中正確呈現字型所需的相關 XML 檔案。

透過程式輔助方式使用可下載字型

自 Android 8.0 (API 級別 26) 起，AndroidX Core 全面支援可下載字型。如要進一步瞭解如何使用 AndroidX Core 程式庫，請參閱本頁的「可下載字型 AndroidX Core 程式庫」一節。

如要透過程式輔助方式使用可下載字型功能，請與以下兩個主要類別互動：

android.graphics.fonts.FontRequest：此類別可讓您建立字型要求。
FontsContractCompat：這個類別可讓您根據字型要求建立新的 Typeface 物件。

應用程式使用 FontsContract API 從字型供應程式擷取字型。每個供應程式對其支援的 Android 版本和查詢語言都有專屬的一組限制。如要進一步瞭解 Android 版本和查詢格式，請參閱供應程式的說明文件。

如要下載字型，請完成下列步驟：

建立 android.graphics.fonts.FontRequest 類別的執行個體，以要求供應器提供字型。如要建立要求，請傳遞下列參數：
- 字型供應程式的授權。
- 用於驗證供應者身分的字型提供者套件。
- 字型的字串查詢。如要進一步瞭解查詢格式，請參閱字型供應程式的說明文件，例如 Google 字型。
- 憑證的雜湊組合，用於驗證提供者的身分。
  注意：如果您向預先安裝的供應程式要求字型，無需新增憑證。不過，如果您透過 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 下載字型，請從 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")
}