Magisk：Android root 与系统定制套件

项目简介

Magisk 是一套用于定制 Android 的开源软件，支持 Android 7.0 以上版本的设备。项目主要使用 Kotlin 开发，以 GPL-3.0 许可证发布。

本项目并非 Google 官方支持的产品。

主要功能

• MagiskSU：为应用提供 root 权限。
• Magisk Modules：通过安装模块修改只读分区。
• MagiskBoot：用于解包和重新打包 Android boot 镜像的完整工具。
• Zygisk：在每个 Android 应用进程中运行代码。

安装与使用

官方 Magisk 信息与下载只通过 GitHub Releases 发布：

• 下载地址：https://github.com/topjohnwu/Magisk/releases
• 安装说明：https://topjohnwu.github.io/Magisk/install.html
• 完整文档：https://topjohnwu.github.io/Magisk/
• 编译与开发：https://topjohnwu.github.io/Magisk/build.html
• Zygisk 模块示例：https://github.com/topjohnwu/zygisk-module-sample

v31.1 主要变化

• 正式支持 Googlebooks（Aluminium OS），可自动给出固件下载建议，并能把 recovery GPT 镜像直接刷写到已连接的 USB 设备。
• 为支持 Googlebooks 而适配 Android 的 Headless System User Mode（HSUM），即用户 0 作为非交互的后台系统用户、真实用户运行在次级用户配置中。
• 重新设计超级用户授权方式，移除传统的交互式 su 授权弹窗，改为在 Magisk 应用的 Superuser 标签页中预先为应用授予超级用户权限。
• 移除应用隐藏（包重打包）功能，因为相关重打包与 stub 管理机制无法兼容 HSUM。

翻译贡献

Magisk 应用的默认字符串资源位于：

app/core/src/main/res/values/strings.xml

把每种翻译放到各自的位置（[module]/src/main/res/values-[lang]/strings.xml）。

注意事项

• 只接受 Debug 构建的缺陷报告。
• 安装问题：需同时上传 boot 镜像和安装日志。
• Magisk 问题：需上传 boot logcat 或 dmesg。
• Magisk 应用崩溃：需录制并上传崩溃发生时的 logcat。

---

本作品整理自 GitHub 开源项目 topjohnwu/Magisk，原作者 @topjohnwu，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。