拓冰网站优化 
从 0 到 1 的 Magisk 模块开发完整指南3 步做出你的第一个系统级模块【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk刚 Root 完手机你是不是也想过能不能给系统加个tree命令能不能换个字体能不能开机自动跑一段脚本这些需求不需要重刷 ROM——用Magisk 模块开发就能实现。Magisk 模块就是一个放在/data/adb/modules下的文件夹开机时它会被自动合并进真实的/system系统文件因此被替换而你的 ROM 分区纹丝不动。读完整篇你会独立写出 module.prop、编好启动脚本、验证挂载生效最后打包成 ZIP 发给任何一台 Root 过的设备。先搞懂原理模块到底是怎么贴上去的一句话类比模块system目录就是一层补丁贴图——开机时 Magisk 把它递归合并到真实的/system上同路径的旧文件被你的新文件覆盖不存在的新文件则被添加进去。真实分区没被写入过一个字节所以随时可以回滚。你只需要记住这个最小骨架/data/adb/modules └── my_first_module # 文件夹名 模块 ID ├── module.prop # 元数据模块身份证 ├── system/ # 会被合并进真实 /system 的目录 ├── post-fs-data.sh # 可选早期启动脚本 └── service.sh # 可选后期启动脚本另外两个关键认知模块里的vendor、product、system_ext是 Magisk 自动生成的软链指向system/下对应子目录你只管往system/里放东西disable、remove这类状态标记文件由 Magisk 自动生成管理不要手工创建。3 分钟搭出第一个模块只写两样东西module.prop模块的身份证在模块根目录创建module.prop格式是严格的keyvalue单行文本idmy_first_module name我的第一个模块 version1.0.0 versionCode1 author你的昵称 description添加命令行工具并替换系统字体边写边看几个容易踩坑的字段id唯一标识必须字母开头只能包含字母、数字和._-。写错格式比如1_module、a module、-a-moduleMagisk 会直接不认这个模块。一旦发布就不要改改了等于换了个新模块。versionCode必须是整数Magisk 靠它比较版本高低做更新检测。version给人看的版本字符串随意写。换行符保存时用UNIX (LF)Windows 默认的CRLF会导致部分字段解析异常。system 目录放什么系统就变成什么system/里放你想替换或新增的文件路径与真实/system完全对齐。想换/system/bin/ls就把新的ls放到system/bin/下。两个进阶技巧先知道在某个文件夹里放一个名为.replace的空文件Magisk 就会整个替换该目录而不是逐文件合并适合整包换掉某个系统应用想删除系统里某个文件比如去掉某个系统 App在对应路径放一个mknod xxx c 0 0生成的哑字符设备即可。到这一步模块已经能被安装了——虽然它还什么都不干。给模块加真本事工具、字体和开机脚本塞进几个命令行工具把编译好或从设备对应架构提取的tree、wget二进制丢进system/bin/。开机合并后这些命令直接出现在系统里adb shell和 Termux 里都能用。记住一点二进制要和设备架构匹配arm64 设备的 64 位程序放 arm64 版本即可。替换系统字体把自定义字体文件重命名为系统默认字体名常见是Roboto-Regular.ttf放进system/fonts/。重启后全局字体即被替换——这是文件覆盖最直观的例子。开机脚本选对时机脚本才有意义Magisk 提供两个模块级脚本执行时机选错时机是新手最常见的失败原因脚本执行时机阻塞性适合干什么post-fs-data.sh系统分区挂载后、Zygote 启动前阻塞最多等 40 秒挂载前调整模块自身文件service.shlate_start 服务阶段非阻塞绝大多数场景包括等开机完成官方建议多数模块只需要service.sh。post-fs-data里调用setprop会直接卡死启动流程要用属性请改用resetprop -n。写service.sh时获取模块路径只有一个正确姿势——用$0推导永远不要硬编码路径#!/system/bin/sh MODDIR${0%/*} # 等待开机完成 resetprop -w sys.boot_completed 0 # 写一条加载日志方便验证脚本真的执行了 date %Y-%m-%d %H:%M:%S loaded $MODDIR/load.log # 顺手设个自定义属性 resetprop -n my.module.enabled 1MODDIR${0%/*}这一行值得刻进肌肉记忆模块目录在不同设备上可能不同写死路径的脚本换个环境就废。装上并确认生效别靠感觉它好了安装方式App 内安装推荐Magisk 管理 App → 模块 → 右上角 → 选 ZIP → 确认后重启命令行安装调试快magisk --install-module /sdcard/my_first_module.zip然后重启。验证三件套重启后依次跑# 1. 模块是否被 Magisk 识别 magisk --list-modules # 2. system 目录是否真的合并进了系统 ls -l /system/fonts/Roboto-Regular.ttf # 看大小/时间戳是否换成你的 # 3. 脚本是否执行过 cat /data/adb/modules/my_first_module/load.log getprop my.module.enabled # 应输出 1三条都通过你的第一个模块才算是真正活着。Magisk App 首页也能看到当前安装状态总览Ramdisk 为 Yes 表示 Magisk 已接管启动流程不听话怎么办按症状对症排查模块装完在 App 里搜不到先别怀疑玄学90% 是下面三类问题之一症状最可能的原因处理办法模块不显示 / 显示为无效id格式不合法或 ZIP 里套了一层外层目录核对id是否字母开头、无空格重新打包ZIP 内直接是 module.prop不要套文件夹文件没覆盖/system里还是旧文件路径没对齐真实/system层级或模块被禁用对照真实路径检查system/内层级确认模块目录下没有disable文件脚本没执行日志没写进去用了post-fs-data.sh但超时被杀或脚本没有执行权限改用service.sh安装前chmod x service.sh两条万能排查命令排障时先跑它们ls -l /data/adb/modules/ # 看模块目录和状态标记文件 logcat | grep -i magisk # 翻 Magisk 的报错最坏情况——某个模块搞到开机循环别慌Magisk 提供完整恢复入口可选择恢复镜像移除模块、保留 Root或完整卸载打包给别人用ZIP 结构和发布渠道一个人见人装的模块 ZIP要点只有三条ZIP 根层级直接放模块文件module.prop在 ZIP 第一层不要多套一层my_first_module/目录——这是新人打包翻车的头号原因只在需要 Recovery 刷入时才加META-INF把仓库里的 scripts/module_installer.sh 复制为META-INF/com/google/android/update-binary再建一个内容只有一行#MAGISK的updater-script。纯 App 内安装的模块连这两样都可以省需要按设备架构装文件、改权限时写一个customize.sh它会在文件解压、默认权限应用完成后被源加载里面能用ARCH、API、IS64BIT等变量和set_perm系列函数比如按$API判断系统版本、对system/bin目录set_perm_recursive $MODPATH/system/bin 0 2000 0755 0755。注意customize.sh结尾不要exit要留给安装脚本做收尾清理。发布渠道按受众选Magisk 模块仓库走官方模块源App 里可搜索、可查更新在module.prop里加updateJson指向你的版本 JSONJSON 里给version、versionCode、zipUrl、changelog四项XDA 等论坛配一篇带安装说明的帖子社区传播最快GitHub Releases仓库发布页自带版本历史和更新日志适合长期维护的模块。发布前过一遍清单id与现有模块不冲突、至少测过 3 个不同 Android 版本、卸载路径验证过生成remove标记后重启文件应干净消失。下一步去哪从能跑到好玩模块跑通之后进阶路线基本就是这三条Zygisk 方向在zygisk/目录按架构放.soarm64-v8a.so、armeabi-v7a.so等代码会在每个应用进程启动前注入做进程级拦截和增强这是性能与玩法都最高的方向。脚本里还能读到ZYGISK_ENABLED环境变量判断其是否启用SELinux 与属性在模块里加sepolicy.rule写自定义策略规则、加system.prop加载系统属性补齐文件覆盖之外的两种系统级能力用官方模板起步不想从零建目录直接基于社区维护的 Magisk 模块模板和 Zygisk 示例工程改结构、customize.sh骨架都是现成的。想深入细节仓库内的 官方模块开发指南 是最权威的一手资料module.prop字段规范、.replace机制、customize.sh可用变量全都写在那安装脚本逻辑可以直接对着 module_installer.sh 读。小结Magisk 模块的本质 module.prop身份证 system/覆盖目录 两个时机正确的脚本。把这三样写对验证、打包、分发都是顺水推舟的事——现在就可以打开编辑器写出你的第一个module.prop了。【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从 0 到 1 的 Magisk 模块开发完整指南：3 步做出你的第一个系统级模块
从 0 到 1 的 Magisk 模块开发完整指南3 步做出你的第一个系统级模块【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk刚 Root 完手机你是不是也想过能不能给系统加个tree命令能不能换个字体能不能开机自动跑一段脚本这些需求不需要重刷 ROM——用Magisk 模块开发就能实现。Magisk 模块就是一个放在/data/adb/modules下的文件夹开机时它会被自动合并进真实的/system系统文件因此被替换而你的 ROM 分区纹丝不动。读完整篇你会独立写出 module.prop、编好启动脚本、验证挂载生效最后打包成 ZIP 发给任何一台 Root 过的设备。先搞懂原理模块到底是怎么贴上去的一句话类比模块system目录就是一层补丁贴图——开机时 Magisk 把它递归合并到真实的/system上同路径的旧文件被你的新文件覆盖不存在的新文件则被添加进去。真实分区没被写入过一个字节所以随时可以回滚。你只需要记住这个最小骨架/data/adb/modules └── my_first_module # 文件夹名 模块 ID ├── module.prop # 元数据模块身份证 ├── system/ # 会被合并进真实 /system 的目录 ├── post-fs-data.sh # 可选早期启动脚本 └── service.sh # 可选后期启动脚本另外两个关键认知模块里的vendor、product、system_ext是 Magisk 自动生成的软链指向system/下对应子目录你只管往system/里放东西disable、remove这类状态标记文件由 Magisk 自动生成管理不要手工创建。3 分钟搭出第一个模块只写两样东西module.prop模块的身份证在模块根目录创建module.prop格式是严格的keyvalue单行文本idmy_first_module name我的第一个模块 version1.0.0 versionCode1 author你的昵称 description添加命令行工具并替换系统字体边写边看几个容易踩坑的字段id唯一标识必须字母开头只能包含字母、数字和._-。写错格式比如1_module、a module、-a-moduleMagisk 会直接不认这个模块。一旦发布就不要改改了等于换了个新模块。versionCode必须是整数Magisk 靠它比较版本高低做更新检测。version给人看的版本字符串随意写。换行符保存时用UNIX (LF)Windows 默认的CRLF会导致部分字段解析异常。system 目录放什么系统就变成什么system/里放你想替换或新增的文件路径与真实/system完全对齐。想换/system/bin/ls就把新的ls放到system/bin/下。两个进阶技巧先知道在某个文件夹里放一个名为.replace的空文件Magisk 就会整个替换该目录而不是逐文件合并适合整包换掉某个系统应用想删除系统里某个文件比如去掉某个系统 App在对应路径放一个mknod xxx c 0 0生成的哑字符设备即可。到这一步模块已经能被安装了——虽然它还什么都不干。给模块加真本事工具、字体和开机脚本塞进几个命令行工具把编译好或从设备对应架构提取的tree、wget二进制丢进system/bin/。开机合并后这些命令直接出现在系统里adb shell和 Termux 里都能用。记住一点二进制要和设备架构匹配arm64 设备的 64 位程序放 arm64 版本即可。替换系统字体把自定义字体文件重命名为系统默认字体名常见是Roboto-Regular.ttf放进system/fonts/。重启后全局字体即被替换——这是文件覆盖最直观的例子。开机脚本选对时机脚本才有意义Magisk 提供两个模块级脚本执行时机选错时机是新手最常见的失败原因脚本执行时机阻塞性适合干什么post-fs-data.sh系统分区挂载后、Zygote 启动前阻塞最多等 40 秒挂载前调整模块自身文件service.shlate_start 服务阶段非阻塞绝大多数场景包括等开机完成官方建议多数模块只需要service.sh。post-fs-data里调用setprop会直接卡死启动流程要用属性请改用resetprop -n。写service.sh时获取模块路径只有一个正确姿势——用$0推导永远不要硬编码路径#!/system/bin/sh MODDIR${0%/*} # 等待开机完成 resetprop -w sys.boot_completed 0 # 写一条加载日志方便验证脚本真的执行了 date %Y-%m-%d %H:%M:%S loaded $MODDIR/load.log # 顺手设个自定义属性 resetprop -n my.module.enabled 1MODDIR${0%/*}这一行值得刻进肌肉记忆模块目录在不同设备上可能不同写死路径的脚本换个环境就废。装上并确认生效别靠感觉它好了安装方式App 内安装推荐Magisk 管理 App → 模块 → 右上角 → 选 ZIP → 确认后重启命令行安装调试快magisk --install-module /sdcard/my_first_module.zip然后重启。验证三件套重启后依次跑# 1. 模块是否被 Magisk 识别 magisk --list-modules # 2. system 目录是否真的合并进了系统 ls -l /system/fonts/Roboto-Regular.ttf # 看大小/时间戳是否换成你的 # 3. 脚本是否执行过 cat /data/adb/modules/my_first_module/load.log getprop my.module.enabled # 应输出 1三条都通过你的第一个模块才算是真正活着。Magisk App 首页也能看到当前安装状态总览Ramdisk 为 Yes 表示 Magisk 已接管启动流程不听话怎么办按症状对症排查模块装完在 App 里搜不到先别怀疑玄学90% 是下面三类问题之一症状最可能的原因处理办法模块不显示 / 显示为无效id格式不合法或 ZIP 里套了一层外层目录核对id是否字母开头、无空格重新打包ZIP 内直接是 module.prop不要套文件夹文件没覆盖/system里还是旧文件路径没对齐真实/system层级或模块被禁用对照真实路径检查system/内层级确认模块目录下没有disable文件脚本没执行日志没写进去用了post-fs-data.sh但超时被杀或脚本没有执行权限改用service.sh安装前chmod x service.sh两条万能排查命令排障时先跑它们ls -l /data/adb/modules/ # 看模块目录和状态标记文件 logcat | grep -i magisk # 翻 Magisk 的报错最坏情况——某个模块搞到开机循环别慌Magisk 提供完整恢复入口可选择恢复镜像移除模块、保留 Root或完整卸载打包给别人用ZIP 结构和发布渠道一个人见人装的模块 ZIP要点只有三条ZIP 根层级直接放模块文件module.prop在 ZIP 第一层不要多套一层my_first_module/目录——这是新人打包翻车的头号原因只在需要 Recovery 刷入时才加META-INF把仓库里的 scripts/module_installer.sh 复制为META-INF/com/google/android/update-binary再建一个内容只有一行#MAGISK的updater-script。纯 App 内安装的模块连这两样都可以省需要按设备架构装文件、改权限时写一个customize.sh它会在文件解压、默认权限应用完成后被源加载里面能用ARCH、API、IS64BIT等变量和set_perm系列函数比如按$API判断系统版本、对system/bin目录set_perm_recursive $MODPATH/system/bin 0 2000 0755 0755。注意customize.sh结尾不要exit要留给安装脚本做收尾清理。发布渠道按受众选Magisk 模块仓库走官方模块源App 里可搜索、可查更新在module.prop里加updateJson指向你的版本 JSONJSON 里给version、versionCode、zipUrl、changelog四项XDA 等论坛配一篇带安装说明的帖子社区传播最快GitHub Releases仓库发布页自带版本历史和更新日志适合长期维护的模块。发布前过一遍清单id与现有模块不冲突、至少测过 3 个不同 Android 版本、卸载路径验证过生成remove标记后重启文件应干净消失。下一步去哪从能跑到好玩模块跑通之后进阶路线基本就是这三条Zygisk 方向在zygisk/目录按架构放.soarm64-v8a.so、armeabi-v7a.so等代码会在每个应用进程启动前注入做进程级拦截和增强这是性能与玩法都最高的方向。脚本里还能读到ZYGISK_ENABLED环境变量判断其是否启用SELinux 与属性在模块里加sepolicy.rule写自定义策略规则、加system.prop加载系统属性补齐文件覆盖之外的两种系统级能力用官方模板起步不想从零建目录直接基于社区维护的 Magisk 模块模板和 Zygisk 示例工程改结构、customize.sh骨架都是现成的。想深入细节仓库内的 官方模块开发指南 是最权威的一手资料module.prop字段规范、.replace机制、customize.sh可用变量全都写在那安装脚本逻辑可以直接对着 module_installer.sh 读。小结Magisk 模块的本质 module.prop身份证 system/覆盖目录 两个时机正确的脚本。把这三样写对验证、打包、分发都是顺水推舟的事——现在就可以打开编辑器写出你的第一个module.prop了。【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考