Skip to content
ackd7Public

About

Android custom font switcher (Magisk/KernelSU/APatch WebUI) & per-app Xposed font manager

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

16 Commits

Folders and files

Repository files navigation

FlexFont

Android 自选字体管理模块(Magisk / KernelSU / APatch + Xposed)
支持全局自定义字体切换 + 分应用(Per-App)独立字体覆盖 + 系统 font*.xml 自动适配 + GMS 字体屏蔽


✨ 核心特性

本项目参考 MakeFontsGreatAgain (MFGA) 的系统字体覆盖与 GMS 屏蔽机制,面向自定义字体选择场景重新设计:

  1. 全局自选字体切换(WebUI)
    • 将任意 .ttf / .otf / .ttc 字体文件(或包含多字重的字体文件夹)放入手机 /sdcard/FlexFont/ 目录。
    • 在 KernelSU / APatch / MMRL 的模块 WebUI 中一键扫描导入、切换全局主字体或恢复系统默认字体。
    • 动态基于设备原厂 /system/etc/fonts.xml 注入主字体配置,完整保留原厂 Emoji、符号及 Fallback 字体链,不破坏系统原有字体结构。
  2. 独立管理 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 与现代 libxposed API 100+)。
    • 支持针对单个 App 独立设置「跟随系统 / 强制使用系统全局字体 / 指定专属自定义字体」。
  3. 小米 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 别名统一重定向至自选字体。
  4. 系统 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。
  5. GMS 字体屏蔽
    • 内置 action.sh 与 WebUI 一键开关,停用 GMS 字体服务并清理 /data/fonts 及 GMS 字体缓存,覆盖 Google 系应用。
  6. GitHub Actions 自动编译打包
    • 推送代码后自动编译 FlexFont-Xposed.apk 与 Zygisk .so,并打包可直接刷入的 FlexFont-Module.zip。

📦 安装与使用

1. 获取构建产物

前往本仓库的 Actions 页面,点击最新一次成功的 Build FlexFont 工作流,下载以下产物:

  • FlexFont-Module:包含可刷入 Magisk / KernelSU / APatch 的模块压缩包 FlexFont-v*.zip
  • FlexFont-Xposed-APK:配套的分应用字体 Xposed 模块 FlexFont-Xposed.apk(也已附带在模块 ZIP 的 xposed/ 目录中)

2. 刷入与配置全局字体

  1. 在 Magisk / KernelSU / APatch 中刷入 FlexFont-*.zip 并重启手机。
  2. 将你想使用的字体文件(.ttf / .otf / .ttc)放入手机存储目录:
    /sdcard/FlexFont/
    

    支持直接放单个字体文件(如 LXGWWenKai.ttf),也支持放多字重文件夹(如 /sdcard/FlexFont/MiSans/Regular.ttf、Bold.ttf 等)。

  3. 打开模块 WebUI(KernelSU / APatch / MMRL),点击 扫描并导入字体,选择想要应用的字体并点击 应用,重启手机即可全局生效。

3. 配置分应用字体(可选)

  1. 安装 FlexFont-Xposed.apk,在 LSPosed 中启用模块并勾选需要生效的目标应用。
  2. 打开 FlexFont 模块 WebUI -> 切换到 分应用字体 标签页。
  3. 选择目标应用并设置「强制全局字体」或「指定自定义字体」,保存后强行停止目标应用即可生效。

🗂️ 目录结构

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)

🙏 致谢

📄 License

本项目基于 MIT License 开源。

About

Android custom font switcher (Magisk/KernelSU/APatch WebUI) & per-app Xposed font manager

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages