为 Android 换上任意喜欢的字体，你可以试试这个 Magisk 模块

本文综合微信公众号「霞鹜」（lxgwshare），点击此处阅读原文。第一次在少数派上写文章，疏漏之处在所难免，还望各位读者多多包涵和批评指正。

由 @topjohnwu 开发的 Magisk 以其 systemless（不改动系统）特性成功代替了以往的 root 神器 SuperSU，成为当前 Android 玩机爱好者的必备工具之一。通过 Magisk 我们不仅可以获取 root 权限，还可以挂载各种模块来实现系统优化或功能增强。

关联阅读：

而对一些手机美化爱好者来说，更换系统字体是一种常见的需求。但不同系统下替换字体的方式也不尽相同，比如 MIUI、EMUI 等定制 ROM 可以通过将字体文件做成主题包，通过导入主题的方式实现系统字体更换；而没有主题字体功能的手机则需要先获取 root 权限，然后才能手动对系统字体进行更换（因为字体文件一般在系统文件夹 system/fonts 里）。

在 TWRP 等第三方 recovery 出现后，字体卡刷包也出现了，它们为 root 替换字体的玩家们提供了不少便利。但这种方法不但修改了系统的文件，而且不易卸载（需要对原机字体进行备份），直到上面提到的 Magisk 的出现，才彻底改变了 Android 手机的字体更换体验——借助 Magisk 字体模块，我们可以将喜爱的字体和修改后的配置文件打包成模块，利用 Magisk 的 systemless 特性挂载达到更换系统字体的目的。模块化的字体也易于更换和卸载。

Magisk 字体模块的「得」与「失」

和上面提到的利用主题更换字体的方法相比，Magisk 字体模块最大的优势在于可以实现多字重显示和全局替换。

某些 ROM 利用主题包更换字体时，只能替换和显示一个字重且无法实现全局覆盖（如 MIUI 使用主题方法更换字体之后，Webview 还是显示为默认字体）。而用 Magisk 字体模块，这个问题就能得到解决。

左图为 MIUI 主题商店里某字体的显示效果，右图为某字体模块替换后的显示效果，可以看到用模块可以实现全局覆盖以及多字重替换。

但 Magisk 字体模块在制作上比较麻烦：我们需要将一款字体制作成多个字体文件用来替换英文、中文字体，还要修改 fonts.xml 描述文件来实现对多字重字体的调用。

相比而言主题包的制作更加简单，只需要一个 ttf 格式的字体和一个可以将字体打包成主题的美化软件，比 Magisk 字体模块更容易制作（而且主题替换方法无需 root 权限）。

因此自然会有人问：

有没有更简单的方法，可以将自己喜欢的 ttf 格式字体转换成 Magisk 模块，不用苦等字体模块作者手动制作吗？

为此我制作了一个字体模块模板，借助这个模块，你可以将自己喜爱的 ttf 字体打包成 Magisk 模块，实现系统字体全局替换。

字体模块模板的制作历程

以下是制作 TTF 转 Magisk 模块模板的基本原理和制作过程，如果你感兴趣的话不妨阅读了解一下。

从 fonts.xml 下手，了解系统字体调用原理

从 Android 7.0 开始，Android 系统的字体就由一个 fonts.xml 文件（在 system/etc 目录下存放）来控制。这个 XML 文件用来定义系统的默认字体，以及多语种字体的调用情况。系统利用 fonts.xml 从上往下调用文件里面指定的字体，最先调用的就是默认字体，如果默认字体缺失，可能会导致无法进入系统。

在 fonts.xml 里，最先被调用的就是系统的默认字体 Roboto 了。下面是系统默认 sans-serif 字体 Roboto 的调用语句。

    <!-- first font is default -->
    <family name="sans-serif">
        <font weight="100" style="normal">Roboto-Thin.ttf</font>
        <font weight="100" style="italic">Roboto-ThinItalic.ttf</font>
        <font weight="300" style="normal">Roboto-Light.ttf</font>
        <font weight="300" style="italic">Roboto-LightItalic.ttf</font>
        <font weight="400" style="normal">Roboto-Regular.ttf</font>
        <font weight="400" style="italic">Roboto-Italic.ttf</font>
        <font weight="500" style="normal">Roboto-Medium.ttf</font>
        <font weight="500" style="italic">Roboto-MediumItalic.ttf</font>
        <font weight="900" style="normal">Roboto-Black.ttf</font>
        <font weight="900" style="italic">Roboto-BlackItalic.ttf</font>
        <font weight="700" style="normal">Roboto-Bold.ttf</font>
        <font weight="700" style="italic">Roboto-BoldItalic.ttf</font>
    </family>

再往下就是一些变体（serif、sans-serif condensed、monospace 等）的调用语句，然后就是 fallback 字体了，一般是多语种字体，family 标签后面都有所对应的语言。［下面是中日韩文字体（下称 CJK 字体）的调用语句。］

    <family lang="zh-Hans">
        <font weight="400" style="normal" index="2">NotoSansCJK-Regular.ttc</font>
        <font weight="400" style="normal" index="2" fallbackFor="serif">NotoSerifCJK-Regular.ttc</font>
    </family>
    <family lang="zh-Hant,zh-Bopo">
        <font weight="400" style="normal" index="3">NotoSansCJK-Regular.ttc</font>
        <font weight="400" style="normal" index="3" fallbackFor="serif">NotoSerifCJK-Regular.ttc</font>
    </family>
    <family lang="ja">
        <font weight="400" style="normal" index="0">NotoSansCJK-Regular.ttc</font>
        <font weight="400" style="normal" index="0" fallbackFor="serif">NotoSerifCJK-Regular.ttc</font>
    </family>
    <family lang="ko">
        <font weight="400" style="normal" index="1">NotoSansCJK-Regular.ttc</font>
        <font weight="400" style="normal" index="1" fallbackFor="serif">NotoSerifCJK-Regular.ttc</font>
    </family>

在坚果 Pro 3 发布的时候，坚果推出了方正定制的 UI 字体——Smartisan T黑。随后我收到了某个大佬分享的 Smartisan OS 7.0 字体及配置文件。在分析 Smartisan OS 字体配置的时候，发现它的默认字体是这么配置的：

    <family name="sans-serif">
        <font weight="100" style="normal">Smartisan_Compact-Thin.otf</font>
        <font weight="300" style="normal">Smartisan_Compact-Light.otf</font>
        <font weight="400" style="normal">Smartisan_Compact-Regular.otf</font>
        <font weight="500" style="normal">Smartisan_Compact-Medium.otf</font>
        <font weight="900" style="normal">Smartisan_Compact-Heavy.otf</font>
        <font weight="700" style="normal">Smartisan_Compact-Bold.otf</font>
    </family>
    ……
    <family>
        <font weight="100" style="normal">Roboto-Thin.ttf</font>
        <font weight="100" style="italic">Roboto-ThinItalic.ttf</font>
        <font weight="300" style="normal">Roboto-Light.ttf</font>
        <font weight="300" style="italic">Roboto-LightItalic.ttf</font>
        <font weight="400" style="normal">Roboto-Regular.ttf</font>
        <font weight="400" style="italic">Roboto-Italic.ttf</font>
        <font weight="500" style="normal">Roboto-Medium.ttf</font>
        <font weight="500" style="italic">Roboto-MediumItalic.ttf</font>
        <font weight="900" style="normal">Roboto-Black.ttf</font>
        <font weight="900" style="italic">Roboto-BlackItalic.ttf</font>
        <font weight="700" style="normal">Roboto-Bold.ttf</font>
        <font weight="700" style="italic">Roboto-BoldItalic.ttf</font>
    </family>

也就是说，Smartisan OS 7.0 把 6 字重的 Smartisan T 黑作为系统默认调用的字体，把 Roboto 作为 fallback 字体，使 Smartisan T 黑缺字部分 fallback 到 Roboto 上，然后再往下 fallback，在调用 T 黑的同时保证不缺字（估计大多数魔改过字体的定制 ROM 一般都是这么调用的）。

我从中受到了启发，得到了 TTF 转 Magisk 模块的基本思路。

修改 fonts.xml，使其调用自定义字体¹

在受到启发之后我突发奇想，假如有一个自定义的 ttf 格式的字体名叫「font.ttf」，将其放在系统的字体文件夹 system/fonts 下，然后让系统默认调用这个字体，不就实现 TTF 字体更换了吗？

于是我对 fonts.xml 进行了如下修改：

将 fonts.xml 里面调用默认字体的部分进行修改：

    <!-- first font is default -->
    <family name="sans-serif">

        <font weight="400" style="normal">font.ttf</font>
    </family>

在后面 fallback 字体的部分加上对 Roboto 的调用：

    <!-- fallback fonts -->
    <family>
        <font weight="100" style="normal">Roboto-Thin.ttf</font>
        <font weight="100" style="italic">Roboto-ThinItalic.ttf</font>
        <font weight="300" style="normal">Roboto-Light.ttf</font>
        <font weight="300" style="italic">Roboto-LightItalic.ttf</font>
        <font weight="400" style="normal">Roboto-Regular.ttf</font>
        <font weight="400" style="italic">Roboto-Italic.ttf</font>
        <font weight="500" style="normal">Roboto-Medium.ttf</font>
        <font weight="500" style="italic">Roboto-MediumItalic.ttf</font>
        <font weight="900" style="normal">Roboto-Black.ttf</font>
        <font weight="900" style="italic">Roboto-BlackItalic.ttf</font>
        <font weight="700" style="normal">Roboto-Bold.ttf</font>
        <font weight="700" style="italic">Roboto-BoldItalic.ttf</font>
    </family>

在调用 CJK 字体的语句前面再加上如下语句，防止西文变体在调用之后直接调用默认的思源黑体：

    <family lang="zh-Hans">
        <font weight="400" style="normal">font.ttf</font>
    </family>
    <family lang="zh-Hant">
        <font weight="400" style="normal">font.ttf</font>
    </family>
    <family lang="ja">
        <font weight="400" style="normal">font.ttf</font>
    </family>
    <family lang="ko">
        <font weight="400" style="normal">font.ttf</font>
    </family>

有些类原生 ROM 桌面会调用 Condensed 字体，为了使其调用自定义 ttf 字体，作者在调用 Condensed 语句处做了如下修改：

    <alias name="sans-serif-condensed" to="sans-serif" />
    <alias name="sans-serif-condensed-light" to="sans-serif-condensed" weight="300" />
    <alias name="sans-serif-condensed-medium" to="sans-serif-condensed" weight="500" />

然后把修改之后的 fonts.xml 打包成 Magisk 模块，将其放入模块里的 system/etc 文件夹内，再将自定义的字体文件重命名为 font.ttf 放入模块的 system/fonts 文件夹内，然后将该模块刷入。

重启，就可以看到系统字体已经被替换成自定义的 font.ttf 了。

以从 OPPO 官网下载的 OPPO Sans 为例，利用 TTF 转 Magisk 模块模板，可以将系统字体更换为 OPPO Sans，而无需修改系统字体文件。

相应地，单字重字体如果不想看到系统强制渲染加粗糊成一块的效果，可以让所有字重都调用这个 font.ttf：²

    <!-- first font is default -->
    <family name="sans-serif">
        <font weight="100" style="normal">font.ttf</font>
        <font weight="300" style="normal">font.ttf</font>
        <font weight="400" style="normal">font.ttf</font>
        <font weight="500" style="normal">font.ttf</font>
        <font weight="900" style="normal">font.ttf</font>
        <font weight="700" style="normal">font.ttf</font>
    </family>

如果是一有多个字重的字体家族，想让系统调用多个字重，可以这么改（当然必须将多字重字体按照字重等级命名为「fontw1.ttf」~「fontw9.ttf」放到 system/fonts 目录下）。³

    <!-- first font is default -->
    <family name="sans-serif">
        <font weight="100" style="normal">fontw1.ttf</font>
        <font weight="200" style="normal">fontw2.ttf</font>
        <font weight="300" style="normal">fontw3.ttf</font>
        <font weight="400" style="normal">fontw4.ttf</font>
        <font weight="500" style="normal">fontw5.ttf</font>
        <font weight="600" style="normal">fontw6.ttf</font>
        <font weight="700" style="normal">fontw7.ttf</font>
        <font weight="800" style="normal">fontw8.ttf</font>
        <font weight="900" style="normal">fontw9.ttf</font>
    </family>

一个新的问题

这样是能实现系统字体更换了，但是有个问题：有些字体由于自身的度量数据，以及一些字符的影响，在使用模块模板更换字体之后，可能会有偏移或者行距过大等问题（比如思源黑体/思源宋体，因为某些字符的影响，直接应用该字体会导致偏移严重）。

从字体层面上解决这样的问题，不仅要考虑度量，还要考虑是否有过长的字符造成这样的偏移，比较麻烦。

有一天，在极限论坛，偶然发现了极限大神「RadarNyan」（下称 R 大）分享了 ta 对于更换字体偏移的思路（帖子时间比较久远，但对 6.0 以上的 Android 仍然适用）。

简要说一下 R 大的思路：将系统默认字体 Roboto 的 12 个字体文件（6 个字重×2 个变体）掏空，保留其度量数据，做成 RobotoFake 文件，然后修改 fonts.xml，使系统首先调用 RobotoFake 空字体文件来控制所显示字体的度量参数，然后向下 fallback 到自定义字体文件和 Roboto；之后在中日韩文处再调用一遍自定义字体文件，然后再调用系统默认的 NotoSansCJK 来补全缺字。感兴趣的，可以点击这里了解一下详细的思路。

解决偏移⁴

于是，作者在模块模板的 system/fonts 目录里面加入了 R 大制作的 12 个「RobotoFake」字体文件，然后对 fonts.xml 进行了修改：

主要是在调用默认字体的语句处做如下修改：

    <!-- 首先调用 RobotoFake 字体，控制所显示字体的度量参数，防止出现偏移 -->
    <family name="sans-serif">
        <font weight="100" style="normal">RobotoFake-Thin.ttf</font>
        <font weight="100" style="italic">RobotoFake-ThinItalic.ttf</font>
        <font weight="300" style="normal">RobotoFake-Light.ttf</font>
        <font weight="300" style="italic">RobotoFake-LightItalic.ttf</font>
        <font weight="400" style="normal">RobotoFake-Regular.ttf</font>
        <font weight="400" style="italic">RobotoFake-Italic.ttf</font>
        <font weight="500" style="normal">RobotoFake-Medium.ttf</font>
        <font weight="500" style="italic">RobotoFake-MediumItalic.ttf</font>
        <font weight="900" style="normal">RobotoFake-Black.ttf</font>
        <font weight="900" style="italic">RobotoFake-BlackItalic.ttf</font>
        <font weight="700" style="normal">RobotoFake-Bold.ttf</font>
        <font weight="700" style="italic">RobotoFake-BoldItalic.ttf</font>
    </family>
    <!-- 调用自定义字体文件 -->
    <family>
        <font weight="400" style="normal">font.ttf</font>
    </family>    
<!-- 缺少的字符向下 fallback -->
    <family>
        <font weight="100" style="normal">Roboto-Thin.ttf</font>
        <font weight="100" style="italic">Roboto-ThinItalic.ttf</font>
        <font weight="300" style="normal">Roboto-Light.ttf</font>
        <font weight="300" style="italic">Roboto-LightItalic.ttf</font>
        <font weight="400" style="normal">Roboto-Regular.ttf</font>
        <font weight="400" style="italic">Roboto-Italic.ttf</font>
        <font weight="500" style="normal">Roboto-Medium.ttf</font>
        <font weight="500" style="italic">Roboto-MediumItalic.ttf</font>
        <font weight="900" style="normal">Roboto-Black.ttf</font>
        <font weight="900" style="italic">Roboto-BlackItalic.ttf</font>
        <font weight="700" style="normal">Roboto-Bold.ttf</font>
        <font weight="700" style="italic">Roboto-BoldItalic.ttf</font>
    </family>

多字重的修改方法可见上上一节，这里不再赘述。

经过上述优化之后，再用同样的字体，偏移问题得到了解决。

模块模板的获取和使用

模板下载：

OneDrive | Dropbox | Google Drive | 百度云（提取码 9ep7）| 蓝奏云（提取码 88zx）

包括 2.0 和 3.0 两个版本，分别包含 a（单字重版）、b（单字重防止加粗变糊版）、c（多字重版）。不懂三者区别的可返回到「字体模块模板的制作历程」一章进行了解。

单字重模块模板

将自己喜爱的 TTF 格式文件重命名为 「font.ttf」（区分大小写，otf 扩展名要改成 ttf），然后复制到模块模板里的 「system/fonts」文件夹内，刷入，重启，即可看到效果。

点击此处查看详细的使用方法示例。

多字重模块模板

将自己喜爱的字体家族按照字重等级重命名为「fontw#.ttf」（# 号表示 1~9 的阿拉伯数字，从 1 到 9 分别对应 Extralight、Thin、Light、Regular、Medium、Semibold、Bold、Heavy、Black 由细到粗 9 个字重，区分大小写，otf 扩展名要改成 ttf），然后复制到模块模板里的 「system/fonts」文件夹内，刷入，重启，即可看到效果。

点击此处查看详细的使用方法示例。

修改模块信息

可以通过修改模块里的 「module.prop」 修改模块信息。

id=lxgwttf2magisk  
# 模块的 ID，只支持半角英文和数字，不能以纯数字开头
name=TTF 转 Magisk 模块模版  
# 模块的名称，模块刷入后，此名称会在 Magisk Manager 里显示
version=3.0
# 模块的版本
versionCode=5
# 模块的版本代号
author=落霞孤鹜 [lxgwshare]
# 模块的作者
description=
# 这里填写模块描述，模块刷入后会在 Magisk Manager 里显示
minMagisk=17000
# 支持此模块的最低 Magisk 版本

特别注意

使用前需要解 Bootloader 锁，并刷入 Magisk。解锁过程会清除所有数据，强烈建议解锁前先备份手机里的数据。
对于某些魔改过字体的 ROM（如 MIUI11），请慎用本模块，可能会出现兼容性问题。
严禁将此模块用于商业营利用途！

结语

本文介绍了 TTF 转 Magisk 模块模板的制作原理以及使用方法，使用这个模块模板，可以使系统字体的更换变得更加方便快捷。

> 下载少数派客户端、关注少数派公众号，轻松玩转 Magisk 模块 🎭

> 特惠、好用的硬件产品，尽在少数派 sspai 官方店铺 🛒