从像素到灵魂：深入解析字体排印与 Android 字体架构（8）：个性化表达：打包和使用自定义字体
本文是「从像素到灵魂：深入解析字体排印与 Android 字体架构」系列的第 8 篇，共 15 篇。在上一篇中，我们探讨了「指令式操作：在代码中动态设置字体」的相关内容。
第四章：个性化表达：打包和使用自定义字体
系统字体虽然强大，但有时我们需要在 App 中使用特定的品牌字体、获得某种独特的视觉风格，或者支持系统字体未能完美覆盖的特殊字符。这时，就需要将自定义字体文件打包到我们的 App 中。
1. 为何要打包自定义字体？
- 品牌一致性： 在 App 中使用与品牌视觉识别系统一致的字体。
- 独特视觉风格： 实现独特的设计感，与其他 App 区分开来。
- 特殊语言/字符支持： 提供对某些系统默认支持不佳或风格不理想的语言文字或符号的更好支持。
- 设计需求： 设计师指定了特定的字体用于界面。
2. 字体资源目录：res/font
Android 提供了一个专门用于存放字体资源的目录：res/font。
- 创建目录： 如果你的项目还没有这个目录，可以在 res 目录下手动创建它（右键 res -> New -> Android Resource Directory，选择 Resource type 为 font）。
- 放置字体文件： 将你的字体文件（推荐使用 .ttf 或 TrueType 轮廓的 .otf 格式）复制到这个 res/font 目录下。
- 命名规范： 字体文件名必须遵循 Android 资源文件的命名规范：小写字母、数字、下划线 (_)。例如：my_brand_font_regular.ttf, awesome_display_font.otf。
3. 在 XML 中直接引用单个字体文件
如果你的自定义字体只有一个文件（例如，只有一个 Regular 字重），最简单的方式是在 XML 布局中直接通过 @font/ 引用它：
- 假设你有一个字体文件： res/font/montserrat_regular.ttf
- 在 TextView 中使用：
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello Montserrat Regular"
android:fontFamily="@font/montserrat_regular" />- 工作方式： 系统会自动加载 montserrat_regular.ttf 文件，并将其应用到 TextView。
4. 创建字体家族 XML (推荐方式)
通常，一个字体家族包含多种字重和样式（如 Regular, Bold, Italic, Light 等）。为了让系统能够根据 android:textStyle 属性自动选择正确的字体文件，最佳实践是创建一个字体家族 XML 文件来组织这些相关的字体文件。
- 步骤：
- 将所有字体文件放入 res/font: 例如，你放入了 montserrat_regular.ttf, montserrat_bold.ttf, montserrat_italic.ttf, montserrat_bold_italic.ttf。
- 在 res/font 目录下创建 XML 文件: 例如，创建一个名为 montserrat_family.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/montserrat_regular" />
<font android:fontStyle="italic" android:fontWeight="400" android:font="@font/montserrat_italic" />
<font android:fontStyle="normal" android:fontWeight="700" android:font="@font/montserrat_bold" />
<font android:fontStyle="italic" android:fontWeight="700" android:font="@font/montserrat_bold_italic" />
</font-family>- `<font-family>`：根元素。
- `<font>`：定义家族中的一个具体字体文件。
- android:fontStyle: 设置为 normal 或 italic。
- android:fontWeight: 设置字重的数值 (100-900)。**此属性需要 API 26 或更高版本**。对于较低版本，系统主要依赖 fontStyle 和文件名约定（如果文件名包含 "Bold" 等）。400 代表 Regular，700 代表 Bold。
- android:font: 引用实际的字体文件资源 (@font/文件名，不带扩展名)。- 在布局中使用字体家族 XML：
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello Montserrat Regular"
android:fontFamily="@font/montserrat_family" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello Montserrat Bold"
android:fontFamily="@font/montserrat_family"
android:textStyle="bold" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello Montserrat Italic"
android:fontFamily="@font/montserrat_family"
android:textStyle="italic" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello Montserrat Bold Italic"
android:fontFamily="@font/montserrat_family"
android:textStyle="bold|italic" />- 优势： 这种方式极大地简化了对复杂字体家族的使用。你只需要引用一个 @font/montserrat_family，然后通过标准的 android:textStyle 属性就能让系统自动选择正确的字体文件，代码更清晰，更符合语义。强烈推荐使用这种方式管理自定义字体家族。
5. 在代码中加载自定义字体
如果你需要在代码中加载 res/font 目录下的字体资源，可以使用 ResourcesCompat 类 (属于 AndroidX 库，推荐使用) 或 Resources 类 (原生 API)。
- 使用 ResourcesCompat.getFont(Context context, int id): (推荐)
- 这是从 AndroidX 获取字体资源的首选方式，能更好地处理向后兼容性。
- 示例： Kotlin
// Kotlin
val context: Context = this // Activity 或 Fragment 的 Context
try {
// 加载单个字体文件
val coolTypeface: Typeface? = ResourcesCompat.getFont(context, R.font.my_cool_font)
// 加载字体家族 XML (通常会得到家族中的默认字体，如 Regular)
val brandTypeface: Typeface? = ResourcesCompat.getFont(context, R.font.my_brand_font_family)
// 应用字体 (记得检查 null)
myTextView.typeface = coolTypeface ?: Typeface.DEFAULT // 提供备选
// 缓存 Typeface! (如之前讨论)
// TypefaceCache.getTypeface(context, "@font/my_cool_font") // 可以封装加载逻辑
} catch (e: Resources.NotFoundException) {
Log.e("FontLoading", "Font not found", e)
// 处理字体未找到的情况
}Java
// Java
Context context = this;
try {
// 加载单个字体文件
Typeface coolTypeface = ResourcesCompat.getFont(context, R.font.my_cool_font);
// 加载字体家族 XML
Typeface brandTypeface = ResourcesCompat.getFont(context, R.font.my_brand_font_family);
// 应用字体 (记得检查 null)
myTextView.setTypeface(coolTypeface != null ? coolTypeface : Typeface.DEFAULT);
// 缓存 Typeface!
} catch (Resources.NotFoundException e) {
Log.e("FontLoading", "Font not found", e);
// Handle the exception
}- 使用 context.resources.getFont(int id): (原生 API, 需要 API 26+)
- 如果你的 minSdkVersion 是 26 或更高，也可以直接使用 Resources 类的方法。
- 用法类似，但 ResourcesCompat 通常更推荐，因为它能处理一些兼容性细节。
6. 重要提醒：检查字体授权！
再次强调，任何你打包到 App 中的自定义字体，都必须拥有允许你在应用程序中嵌入和分发该字体的合法授权。对于商业字体，这意味着你需要购买明确覆盖 App Embedding 的 License；对于开源字体（如 SIL OFL），你需要遵守其许可条款（通常包括保留版权声明和许可证文本）。在添加任何自定义字体前，务必确认授权问题。
小结： 使用 res/font 目录管理自定义字体文件。对于单个字体，可以直接在 XML 中通过 @font/file_name 引用。对于包含多种字重/样式的字体家族，强烈推荐创建字体家族 XML 文件，并通过 @font/family_xml_name 引用，结合 android:textStyle 使用。在代码中加载自定义字体使用 ResourcesCompat.getFont()，并务必缓存 Typeface 对象。时刻牢记检查并遵守字体授权协议。
下一篇我们将探讨「分总结与展望」，敬请关注本系列。
「从像素到灵魂：深入解析字体排印与 Android 字体架构」系列目录
- 万丈高楼平地起：奠定字体排印的坚实基础
- 初识门径：字体的基本分类
- 分小结与展望
- 从曲线到像素——字体渲染管线揭秘
- 无规矩不成方圆——字体授权与合规
- Android 的原生字体生态：Roboto、Noto 与字体回退
- 指令式操作：在代码中动态设置字体
- 个性化表达：打包和使用自定义字体（本文）
- 分总结与展望
- 千变万化，始于一文：可变字体 (Variable Fonts)
- 未雨绸缪：字体预加载 (Font Preloading)
- 放眼全球：国际化 (I18N) 与字体再思考
- 千挑万选：为你的 App 选择合适的字体
- 现代 UI 的字体之道：Jetpack Compose 中的实践
- 包容性设计：无障碍 (Accessibility) 与字体