使用可下載字型

試用 Compose
Jetpack Compose 是 Android 推薦的 UI 工具包。瞭解如何在 Compose 中使用文字。
可下載的字型 →

透過「可下載的字型」功能，API 可以向供應商應用程式要求字型，而不必將檔案繫結至應用程式，或允許應用程式下載字型。可下載的字型可透過 AndroidX Core 程式庫在搭載 Android API 14 以上版本的裝置上執行。

可下載字型的優點如下：

  • 縮減應用程式大小，進而提高應用程式安裝成功率。
  • 改善系統整體健康狀態，因為多個應用程式可以透過供應器共用相同字型。這樣可以節省使用者的行動數據、手機記憶體和磁碟空間。在此模型中，系統會在需要時透過網路擷取字型。
如要實際體驗可下載字型，請參閱 DownloadableFonts 範例應用程式。

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

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

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

基本概念

您可以透過下列方式使用可下載字型功能，詳情請參閱後續章節：

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

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

  1. 在版面配置編輯器中，選取 TextView。然後在「Attributes」(屬性) 下方依序選取「fontFamily」>「More Fonts」(更多字型)。
    顯示 Android Studio 版面配置編輯器的圖片
    圖 2.使用版面配置編輯器。
    系統會隨即顯示「Resources」視窗。
  2. 在「來源」選單中，選取「Google 字型」。
  3. 在「字型」方塊中的「可下載」區域下方選取字型。
  4. 選取「建立可下載的字型」，然後按一下「確定」。
    圖片：說明如何從「Resources」視窗中選取字型
    圖 3.從「Resources」視窗中選取字型。

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

    顯示如何預覽字型的圖片
    圖 4.預覽字型檔案。

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

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

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

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

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

  1. 建立 android.graphics.fonts.FontRequest 類別的執行個體，以要求供應器提供字型。如要建立要求，請傳遞下列參數：
    • 字型提供者的授權。
    • 用於驗證供應者身分的字型提供者套件。
    • 字型的字串查詢。如要進一步瞭解查詢格式，請參閱字型供應程式的說明文件，例如 Google Fonts。
    • 憑證的雜湊組合，用於驗證提供者的身分。

    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);
  2. 建立 FontsContract.FontRequestCallback 類別的執行個體。
  3. 覆寫 onTypefaceRetrieved() 方法，表示字型要求已完成。提供擷取的字型做為參數。您可以使用這個方法，視需要設定字型。舉例來說，您可以在 TextView 上設定字型。
  4. 覆寫 onTypefaceRequestFailed() 方法，即可接收字型要求程序中錯誤的相關資訊。如要進一步瞭解錯誤代碼，請參閱錯誤代碼常數。
  5. 呼叫 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")
}

使用 XML 中的可下載字型做為資源

Android 8.0 (API 級別 26) 和 AndroidX Core 可讓您在 XML 版面配置中，以更快速簡便的方式將自訂字型宣告為資源。也就是說，不需要將字型做為素材資源組合。您可以為整個主題定義自訂字型，提升各種粗細和樣式 (例如粗體、中型或淺色) 的可用性 (如有提供)。

  1. 在　res/font　資料夾中建立新的 XML 檔案。
  2. 新增 <font-family> 根元素，並設定字型相關屬性，如以下 XML 檔案範例所示：
    3. <?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>
  3. 在版面配置 XML 檔案中，將此檔案稱為 @font/font_file_name。您也可以使用 getFont() 方法，透過程式輔助方式擷取檔案 (例如 getFont(R.font.font_file_name))。

在資訊清單中預先宣告字型

版面配置加載和資源擷取是同步工作。根據預設，首次嘗試擷取字型會觸發對字型提供者提出的要求，因此會增加第一個版面配置時間。如要避免延遲，您可以預先宣告必須在資訊清單中擷取的字型。系統從供應器擷取字型後，即可立即使用。如果字型擷取時間超出預期，系統會取消擷取程序並使用預設字型。

如要在資訊清單中預先宣告字型，請完成下列步驟：

  1. 在 res/values/arrays.xml 中建立資源陣列，並宣告您要預先擷取的字型。
    2. 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>
  2. 使用 meta-data 標記在資訊清單中宣告資源陣列。
    3. <meta-data android:name="preloaded_fonts" android:resource="@array/preloaded_fonts" />

新增憑證

如果未預先安裝字型供應程式，或者您使用的是 AndroidX Core 程式庫，請宣告字型供應程式簽署的憑證。系統會使用憑證來驗證字型供應程式的身分。

請執行下列步驟新增憑證：

  1. 建立一個包含憑證詳細資料的字串陣列。如要進一步瞭解憑證詳情，請參閱字型提供者的說明文件。
    2. <?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array name="certs">
       <item>MIIEqDCCA5CgAwIBAgIJA071MA0GCSqGSIb3DQEBBAUAMIGUMQsww...</item>
    </string-array>
</resources>
  2. 將 fontProviderCerts 屬性設為陣列。
    3. android:fontProviderCerts="@array/certs"

Compose 中的可下載字型

從 Compose 1.2-alpha07 開始，您可以使用 Compose 應用程式中的可下載字型 API，以非同步方式下載 Google Fonts，並在應用程式中使用。詳情請參閱「Compose 可下載字型」說明文件。