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

使用可下載字型

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

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

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

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

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

字型供應程式這類應用程式可用於擷取字型並快取至本機，讓其他應用程式能夠要求及分享字型。下圖說明此程序。

顯示表情符號相容處理程序中主要元件的圖片 — **圖 1**：可下載字型處理程序。

基本概念

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

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

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

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

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

「Resources」視窗隨即顯示。
在「來源」選單中，選取「Google 字型」。
在「字型」方塊中的「可下載」區域下方選取字型。
選取「Create downloadable font」(建立可下載字型)，然後按一下「OK」。

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

Android Studio 會自動產生所需的相關 XML 檔案，以便在應用程式中正確轉譯字型。

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

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

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

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 會為其支援的供應程式在使用者介面中自動填入這些值。
建立 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 和可下載字型

在搭載 Android API 14 以上版本的裝置上，AndroidX Core 支援「可下載字型」功能。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")
}