# 前言

说到搞机，那肯定绕不开大名鼎鼎的Magisk。就我来说，root完后做的第一件事，就是安装各种各样的模块，但是，我却从来没有研究过Magisk的内容。同时，现在也有许多心怀不轨的人制作锁机模块骗人刷入。所以，了解Magisk模块的一些基本内容就显得比较重要了。

# 认识Magisk模块

根据官方的文档，一个典型的Magisk模块的目录应该如下所示：¹

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

module.zip
│
├── META-INF
│   └── com
│       └── google
│           └── android
│               ├── update-binary      <--- 从官方仓库上下载的module_installer.sh
│               └── updater-script     <--- 只有一行文字为 "#MAGISK"
│
├── module.prop                        <--- 模块的标识信息
├── customize.sh                       <--- (可选)用于自定义模块安装过程
├── ...
├── ...  /* 模块的其余文件 */
│

可以看出来，META-INF目录是由官方提供，并不需要我们进行修改。

# module.prop

这个文件是模块的标识信息，模块的基本信息就存放在这里，文件的格式如下。¹

1
2
3
4
5
6
7

id=<string>
name=<string>
version=<string>
versionCode=<int>
author=<string>
description=<string>
updateJson=<url> (optional)

各键值的作用说明如下：

# system文件夹

Magisk的一个主要作用就是对系统文件进行注入或替换，只要将文件按顺序放入此目录中即可。例如我想修改hosts文件，只需要将修改好的hosts文件放入system/etc这个目录下，Magisk就会自动将其替换了。

如果要替换/vendor、/product或/system_ext中的文件，只需将它们分别放在system/vendor、system/product和system/system_ext下。Magisk就会自动替换完成。

# customize.sh

这是自定义模块安装过程，如果只是简单的替换文件就不需要用到它。但是，很多时候我们并不是仅需替换文件，还需要执行一些脚本，这里就需要使用到它了。

根据官方文档，这里支持以下的环境变量：

以及以下的命令：

• ui_print <msg>：在页面上显示信息
• abort <msg>：将错误消息打印到控制台并终止安装
• set_perm和set_perm_recursive：修改文件权限

# 实践

# 修改系统Hosts

我一开始想研究Magisk的契机，就是想要修改我手机的Hosts文件。一开始按百度的教程做，但没有效果，后来就尝试了一下Magisk模块，直接就成功了。

有了前面知识的铺垫，想要实现这个功能就非常简单了，下面列出我们程序的目录树。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

ChangeHosts.zip
├── META-INF
│   └── com
│       └── google
│           └── android
│               └── update-binary
│               └── updater-script
├── module.prop
├── system
    └── etc
        └── hosts

实际我们需要修改的部分只有module.prop和hosts，hosts是我们需要修改的文件，所以我们就只要关注module.prop。

1
2
3
4
5
6

id=ChangeHosts
name=ChangeHosts
version=v1.0.0
versionCode=100
author=luoboQAQ
description=修改hosts文件来屏蔽广告

如此看来，如果只要替换文件，基本没有任何难度。

# 使用dnscrypt-proxy实现DoH

这部分我正在研究，等研究明白了就补上🕊️。