字體資源定義了可在應用中使用的自定義字體。字體可以是單獨的字體文件或字體文件的集合，稱為字體系列，并在 XML 中定義。

另請參閱如何定義 XML 中的字體，或改用可下載字體。

捆綁式字體

您可以將字體作為資源捆綁在應用中。字體在 R 文件中編譯，在系統中可自動作為資源使用。然后，您可以借助 font 資源類型訪問這些字體。

文件位置：

res/font/filename.ttf （.ttf、.ttc、.otf 或 .xml）
該文件名將用作資源 ID。

資源引用：

在 XML 中：@[package:]font/font_name

語法：

 <?xml version="1.0" encoding="utf-8"?>
    <font-family>
      <font
        android:font="@[package:]font/font_to_include"
        android:fontStyle=["normal" | "italic"]
        android:fontWeight="weight_value" />
    </font-family>

　　

 

元素：

<font-family>

必需。該元素必須是根節點。

沒有屬性。

<font>

定義一個系列內的單個字體。不包含子節點。

屬性：

android:fontStyle

關鍵字。定義字體樣式。該屬性用在字體加載到字體堆棧中的情況，并且會替換字體的標頭表格中的任何樣式信息。如果您未指定該屬性，應用將使用字體標頭表格中的值。常量值必須為 normal 或 italic。

android:fontWeight

整數。字體粗細。該屬性用在字體加載到字體堆棧中的情況，并且會替換字體的標頭表格中的任何粗細信息。屬性值必須為為 100 的正倍數，并且介于 100 和 900（含）之間。如果您未指定該屬性，應用將使用字體標頭表格中的值。常規粗細的最常見值為 400，粗體粗細為 700。

示例：

保存于 res/font/lobster.xml 的 XML 文件：

<?xml version="1.0" encoding="utf-8"?>
    <font-family xmlns:android="http://schemas.android.com/apk/res/android">
        <font
            android:fontStyle="normal"
            android:fontWeight="400"
            android:font="@font/lobster_regular" />
        <font
            android:fontStyle="italic"
            android:fontWeight="400"
            android:font="@font/lobster_italic" />
    </font-family>

　　

 

將字體應用于 TextView 的 XML 文件保存在 res/layout/ 中：

 <?xml version="1.0" encoding="utf-8"?>
    <EditText
        android:fontFamily="@font/lobster"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="Hello, World!" />
    

　　

可下載字體

可下載字體資源定義了可在應用中使用的自定義字體。此字體在應用本身中不可用，而是從字體提供程序檢索。

文件位置：

res/font/filename.xml 該文件名用作資源 ID。

資源引用：

在 XML 中：@[package:]font/font_name

語法：

<?xml version="1.0" encoding="utf-8"?>
    <font-family
        android:fontProviderAuthority="authority"
        android:fontProviderPackage="package"
        android:fontProviderQuery="query"
        android:fontProviderCerts="@[package:]array/array_resource" />
    
 

　　

元素：

<font-family>

必需。該元素必須是根節點。

屬性：

android:fontProviderAuthority

字符串。必需。定義字體請求的字體提供程序的授權。

android:fontProviderPackage

字符串。必需。要用于請求的字體提供程序的軟件包名稱。此屬性用于驗證提供程序的身份。

android:fontProviderQuery

字符串。必需。字體的字符串查詢。有關此字符串的格式，請參閱字體提供程序的文檔。

android:fontProviderCerts

數組資源。必需。定義用于為此提供程序簽名的證書的哈希集。此屬性用于驗證提供程序的身份，僅當提供程序不屬于系統映像的一部分時才是必需的。該值可以指向單個列表（字符串數組資源）或列表的列表（數組資源），其中每個單獨的列表代表一個簽名哈希集合。有關這些值，請參閱字體提供程序的文檔。

示例：

保存于 res/font/lobster.xml 的 XML 文件：

<?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="Lobster"
        android:fontProviderCerts="@array/certs">
    </font-family>
    

　　

 

定義證書數組的 XML 文件保存在 res/values/ 中：

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

　　

 

將字體應用于 TextView 的 XML 文件保存在 res/layout/ 中：

<?xml version="1.0" encoding="utf-8"?>
    <EditText
        android:fontFamily="@font/lobster"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="Hello, World!" />