某次 Magisk 版本升级后,就陆续有读者来向我反馈字体模块失效的问题。当然,除了我们这些热衷于换字体的人,其它用户在这次更新后也会遇到模块刷入后没有任何效果的情况。

为什么会出现这样的现象呢?

如果你有 自制 Magisk 模块 的经验,应该或多或少接触过 Magisk 开发者早前为模块开发者提供的 Magisk 模块安装模板(magisk-module-installer)。在早前的 Magisk 版本中我们用到的大部分模块都基于这个模板进行制作,因此大部分情况下 Magisk Manager 都可以正常安装这些模块。

但 Magisk 在 v20.2 版本更新后对模块结构和安装方式进行了调整,上述模板文件所在的 GitHub 仓库目前已被归档并不再使用。

原有模板已经过时

模块开发者转而需要根据 Magisk 作者 @topjohnwu 提供的开发指南对模块进行重新配置——所以 Magisk 模块的兼容性往往也是与 Magisk 版本紧密关联的,我以往所制作的字体模块后缀大多都写着 1500、1700 之类的字样,所代表其实正是其所对应的 Magisk 版本。

这自然就引出了一个大家可能会遇到的问题:

如果开发者无暇适配最新版模块模板导致模块不可用,我们除了等待开发者更新还有别的办法吗?

其实是有的。动手能力较强、拥有一定代码基础的朋友可以参考上面给出的新版开发指南对旧版模块进行拆包重写,在这个过程中你会发现,相比以往新版模块模板最大的不同在于它调整了不同功能模块的生效机制,在这个过程中,有一份名为 update-binary 的「导航」文件尤为重要。

所以不熟悉开发和代码的一般用户也可以从这个 update-binary 下手更新旧版模块的兼容性,以我的字体模块为例,具体的操作流程如下:

在电脑端使用压缩工具打开旧版的字体模块,注意,以下所有操作流程都建议直接在压缩工具中完成操作,不推荐解压、修改再压缩打包!

在压缩工具展示的目录中定位至 META-INF\com\google\android,你会看到有一个无扩展名的 update-binary 文件。

这个 update-binary 文件就是我们要替换的「导航」文件。接下来在浏览器上操作:

  • 打开 Magisk 作者提供的模块安装脚本 地址,选择页面中的「Raw」按钮,然后在打开的新页面中右键空白处选择「另存为」
  • 将保存而来的 module_installer.sh 文件重命名为 update-binary

至此,我们就得到了一份新的 update-binary 文件,把这个文件直接拖拽进入压缩管理器窗口替换旧版模块中对应的原文件,然后保存、关闭压缩管理器即可——一个兼容新版 Magisk,能够正常安装并成功生效的新版字体模块就制作完成了。

本文看着好像篇幅挺长,但实际操作流程无非就是「下载 > 重命名 > 拖拽覆盖」,将 update-binary 这个用来给模块安装过程「指路」的文件更新为最新版本。

最后,经读者提醒,本文介绍的方法严格来说仅适用于字体模块的更新,其它不兼容新版 Magisk 框架的旧模块需要根据实际情况进行调整,详请参阅 Magisk 模块 开发者指南

关联阅读:

> 下载少数派 客户端、关注 少数派公众号,发现更多实用 Android 技巧 👀

[更新 2020/05/13 14:40] 调整了文章关于 update-binary 文件生成和方法适用范围的描述。