KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

UnicodeFontSet-magisk-module

★ 68 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Magisk 模块：扩展 Unicode 字体合集（UFS-Magisk）

</div>
<br/>

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

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

本项目借鉴了 [simonsmh 的 notocjk 模块](https://github.com/simonsmh/notocjk) 和 [lakejason0 的 又又一个遍黑体 Magisk 模块](https://github.com/lakejason0/AAnother-Plangothic-magisk-module) 的实现思路——通过脚本工具动态修改字体配置文件。

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

## 下载方式

请前往 [Releases 页面](https://github.com/Losketch/UnicodeFontSet-magisk-module/releases) 下载最新版本。

## 使用须知

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

## 字体信息

- 📄 [字体来源与许可](docs/LICENSES.md)
- 🙏 [鸣谢名单](docs/CREDITS.md)

## 字体缓存清理工具

### 功能说明

模块内置了 `font-cmap-cleaner` 工具，用于清理字体的 cmap 表，解决以下问题：
- 颜文字（如 ʕ•ᴥ•ʔ、(╯°□°）、 ๑⃙⃘´༥`๑⃙⃘ 、(ͼ̤͂ ͜ ͽ̤͂)✧）显示异常
- Emoji 显示为空白 / 方块 / 错位（如😀.png 、🤓:书呆子脸）

### 使用方法

安装过程中，模块会提示您是否执行 cmap 清理：
- 按下「音量上键」跳过清理
- 按下「音量下键」执行清理
- 15秒无操作将自动跳过

### 注意事项

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

## 常见问题解答（FAQ）

### Q: 安装后某些应用闪退怎么办？
A: Android 12+ 引入了字体加载机制的变化，可能导致传统 Magisk 字体模块出现兼容性问题。请安装 [FontLoader](https://github.com/JingMatrix/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`

### 清理模块残留

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

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

UnicodeFontSet-magisk-module

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README