Android 自选字体管理模块(Magisk / KernelSU / APatch + Xposed)
支持全局自定义字体切换 + 分应用(Per-App)独立字体覆盖 + 系统 font*.xml 自动适配 + GMS 字体屏蔽
本项目参考 MakeFontsGreatAgain (MFGA) 的系统字体覆盖与 GMS 屏蔽机制,面向自定义字体选择场景重新设计:
- 全局自选字体切换(WebUI)
- 将任意
.ttf/.otf/.ttc字体文件(或包含多字重的字体文件夹)放入手机/sdcard/FlexFont/目录。 - 在 KernelSU / APatch / MMRL 的模块 WebUI 中一键扫描导入、切换全局主字体或恢复系统默认字体。
- 动态基于设备原厂
/system/etc/fonts.xml注入主字体配置,完整保留原厂 Emoji、符号及 Fallback 字体链,不破坏系统原有字体结构。
- 将任意
- 独立管理 App + 内置 Xposed 模块(
FlexFont.apk)- 基于 mochi-compose(G2 连续圆角、iOS 弹簧动效、可选 AGSL 液态玻璃浮动底栏)与 Miuix(HyperOS 原生风格卡片与偏好设置控件)打造,与 KernelSU WebUI 采用统一布局并共享
/data/adb/flexfont/同一份配置。 - 二合一 APK:既是可从桌面直接打开的独立管理 App(支持系统文件选择器一键导入
.ttf/.otf/.ttc、真实应用名称检索、Root 命令行控制),同时也内置双入口 Xposed / LSPosed 模块(兼容传统 API 82 与现代libxposedAPI 100+)。 - 支持针对单个 App 独立设置「跟随系统 / 强制使用系统全局字体 / 指定专属自定义字体」。
- 基于 mochi-compose(G2 连续圆角、iOS 弹簧动效、可选 AGSL 液态玻璃浮动底栏)与 Miuix(HyperOS 原生风格卡片与偏好设置控件)打造,与 KernelSU WebUI 采用统一布局并共享
- 小米 MIUI / HyperOS 1~4 专项适配
- 内置原生 Zygisk 模块(
zygisk/arm64-v8a.so、armeabi-v7a.so),自动关闭FontSettings.HAS_MIUI_VAR_FONT、MIUI_OPTIMIZE_ENABLED并设置FontScaleUtil.isCtsBlockListPackage = true,彻底解除 HyperOS 3/4(Android 16+)Flags.newHyperFont()强制字体接管;非小米设备安装时自动移除。 - 在 Android 15+(HyperOS 2/3/4)上优先基于原厂
font_fallback.xml动态生成,注入完整100~900字重的sans-serif与zh,zh-Hans,zh-Hant字族(避免 R 版天气/相册文字挤成一坨),并将miui/mipro/misans别名统一重定向至自选字体。
- 内置原生 Zygisk 模块(
- 系统
font*.xml自动扫描与覆盖- 沿用 MFGA 的
search_dirs.sh+fonts_list.yaml黑白名单机制,自动扫描/system/etc、/product/etc、/system_ext/etc下的font*.xml并同步覆盖,适配类原生、HyperOS/MIUI、ColorOS、OxygenOS、OneUI、Flyme 等 ROM。
- 沿用 MFGA 的
- GMS 字体屏蔽
- 内置
action.sh与 WebUI 一键开关,停用 GMS 字体服务并清理/data/fonts及 GMS 字体缓存,覆盖 Google 系应用。
- 内置
- GitHub Actions 自动编译打包
- 推送代码后自动编译
FlexFont-Xposed.apk与 Zygisk.so,并打包可直接刷入的FlexFont-Module.zip。
- 推送代码后自动编译
前往本仓库的 Actions 页面,点击最新一次成功的 Build FlexFont 工作流,下载以下产物:
FlexFont-Module:包含可刷入 Magisk / KernelSU / APatch 的模块压缩包FlexFont-v*.zipFlexFont-Xposed-APK:配套的分应用字体 Xposed 模块FlexFont-Xposed.apk(也已附带在模块 ZIP 的xposed/目录中)
- 在 Magisk / KernelSU / APatch 中刷入
FlexFont-*.zip并重启手机。 - 将你想使用的字体文件(
.ttf/.otf/.ttc)放入手机存储目录:/sdcard/FlexFont/支持直接放单个字体文件(如
LXGWWenKai.ttf),也支持放多字重文件夹(如/sdcard/FlexFont/MiSans/Regular.ttf、Bold.ttf等)。 - 打开模块 WebUI(KernelSU / APatch / MMRL),点击 扫描并导入字体,选择想要应用的字体并点击 应用,重启手机即可全局生效。
- 安装
FlexFont-Xposed.apk,在 LSPosed 中启用模块并勾选需要生效的目标应用。 - 打开 FlexFont 模块 WebUI -> 切换到 分应用字体 标签页。
- 选择目标应用并设置「强制全局字体」或「指定自定义字体」,保存后强行停止目标应用即可生效。
FlexFont/
├── .github/workflows/build.yml # GitHub Actions 自动编译 APK 与打包模块 ZIP
├── module/ # Magisk / KernelSU / APatch 模块源码
│ ├── META-INF/ # 刷机脚本
│ ├── module.prop # 模块元信息
│ ├── customize.sh # 安装初始化脚本
│ ├── post-fs-data.sh # 早期轻量目录初始化(阻塞阶段)
│ ├── post-mount.sh # KernelSU 挂载后实时 bind-mount(Zygote 前)
│ ├── service.sh # 延迟启动与 Magisk 兼容兜底
│ ├── boot-completed.sh # KernelSU 开机完成后执行的任务
│ ├── action.sh # GMS 字体屏蔽脚本
│ ├── uninstall.sh # 卸载清理脚本
│ ├── fonts_list.yaml # font*.xml 扫描黑白名单配置
│ ├── scripts/
│ │ ├── apply_font.sh # 动态注入 fonts.xml 与全局字体切换核心
│ │ ├── search_dirs.sh # 系统 font*.xml 自动扫描复制
│ │ └── manage_app_fonts.sh # 字体库扫描、导入与分应用配置管理
│ └── webroot/ # KernelSU / MMRL WebUI 界面
└── flexfont-xposed/ # 分应用字体 Xposed 模块源码 (Java/Kotlin)
- Numbersf/MakeFontsGreatAgain:提供了优秀的系统
font*.xml自动适配、GMS 字体屏蔽及 Xposed Typeface Hook 思路。
本项目基于 MIT License 开源。