Skip to content

Losketch/UnicodeFontSet-magisk-module

Repository files navigation

中文版本 English Version

Magisk 模块:扩展 Unicode 字体合集(UFS-Magisk)

Github Visitors GitHub Stars GitHub Forks Github Issues
Github Downloads Version Github Action Platform
Last Commit Commit Activity

本模块无需依赖系统自带字体,通过联合多个字体,实现了对 Unicode 18.0 Alpha 标准中所有已定义字符的完整字形覆盖(不包括代理区和私用区)。
本模块以增量方式安装字体和配置,其他字体模块显示得以保留。

本模块专为已 Root 的 Android 设备设计,通过 Magisk 框架安装一套完整的 Unicode 字体及其配置文件。

本项目借鉴了 simonsmh 的 notocjk 模块lakejason0 的 又又一个遍黑体 Magisk 模块 的实现思路——通过脚本工具动态修改字体配置文件。

模块简介

本模块的核心功能是在系统字体目录(/system/fonts)中安装多个字体文件,并通过脚本动态的修改系统的 fonts.xml 及相关配置文件,为系统字体提供大量补充字符。

下载方式

请前往 Releases 页面 下载最新版本。

使用须知

  • 兼容性: 本模块可能无法兼容所有机型和高定制化系统。更多兼容性信息可参考:
  • 如果系统中已安装其它字体类 Magisk 模块,本模块将以增量方式插入新字体和 XML 配置,不会覆盖原有字体配置,确保已装模块的功能得以保留。
  • 安装顺序:
    • 推荐先安装其他模块并重启一次,再安装本字体模块并重启,以确保兼容性。
    • 若后续其他字体模块更新后导致本模块字体未即时生效,可重启 1–2 次(或再次重新激活 Magisk 模块)即可恢复显示。
  • 字体特性说明: 本合集旨在最大化字符覆盖率与显示稳定性,不包含也无需依赖任何连字或复杂排版特性。对于彩色字体,请确保您的系统和应用支持 COLRv1 格式(Android 12L+ 及现代浏览器已提供支持)。
  • 内核管理器 (KernelSU, APatch):
    • KernelSU 用户:
      • ⚠️ 必须先安装元模块(如 meta-overlayfs),否则 system/fonts/ 中的字体文件将无法挂载生效
      • 更多信息详见 KernelSU 元模块文档
      • 建议关闭 KernelSU 的"默认卸载模块"功能以确保字体正常工作
    • 隐藏工具: 如使用 Shamiko 等,请配置为黑名单模式
  • 免责声明: 本模块按"原样"提供,仅供个人学习与交流使用。使用者需自行承担风险,作者对因安装此模块而可能导致的任何设备问题不承担责任。

字体信息

字体缓存清理工具

功能说明

模块内置了 font-cmap-cleaner 工具,用于清理字体的 cmap 表,解决以下问题:

  • 颜文字(如 ʕ•ᴥ•ʔ、(╯°□°)、 ๑⃙⃘´༥`๑⃙⃘ 、(ͼ̤͂ ͜ ͽ̤͂)✧)显示异常
  • Emoji 显示为空白 / 方块 / 错位(如😀.png 、🤓:书呆子脸)

使用方法

安装过程中,模块会提示您是否执行 cmap 清理:

  • 按下「音量上键」跳过清理
  • 按下「音量下键」执行清理
  • 15秒无操作将自动跳过

注意事项

  • 此操作会修改模块内的字体文件,但操作是安全且可逆的
  • 清理过程可能需要几分钟时间,请耐心等待
  • 清理完成后,您需要重启设备才能看到效果

常见问题解答(FAQ)

Q: 安装后某些应用闪退怎么办?

A: Android 12+ 引入了字体加载机制的变化,可能导致传统 Magisk 字体模块出现兼容性问题。请安装 FontLoader 模块来解决此问题。

Q: 安装后字体没有变化怎么办?

A: 请尝试以下解决方案:

  1. 重启设备 1-2 次
  2. 重新激活模块
  3. 检查是否与其他字体模块冲突
  4. 查看模块日志 ${MODPATH:-/cache}/ufs.log 了解详细信息

Q: 如何检查模块是否正常工作?

A: 您可以通过以下方式验证:

  1. 查看 /system/fonts 目录中是否存在模块安装的字体文件
  2. 检查 /system/etc/fonts.xml/system/product/etc/fonts.xml 中是否包含 UnicodeFontSetModule 相关配置
  3. 使用支持 Unicode 测试的应用查看特殊字符是否能正常显示

Q: 模块支持哪些 Android 版本?

A: 模块支持 Android 8.0+(API 26+)。

故障排除

查看模块日志

模块运行时会生成日志文件,您可以通过以下方式查看:

  • 日志路径:${MODPATH:-/cache}/ufs.log
  • 使用 ADB 命令查看:adb pull ${MODPATH:-/cache}/ufs.log

清理模块残留

如果卸载模块后仍有问题,您可以清理模块残留文件:

su -c rm -rf /data/adb/ufs_lock
su -c rm -rf /cache/ufs.log

About

A full Unicode font set Magisk module / 一个完整 Unicode 字体合集的 Magisk 模块

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors