Magisk Root 安装指南（包括 boot.img 提取）

准备工作

设备需求

已解锁 Bootloader：确保您的设备已解锁 Bootloader。
设备电量充足：确保设备有足够的电量以避免过程中断。

所需工具

ADB 和 Fastboot 工具：点此下载。
Magisk APK：下载最新版。
官方固件文件：确保您拥有适配设备的正确固件文件（可能包括 payload.bin 或其他格式）。

环境要求

电脑：Windows/Linux/macOS。
手机设置：启用 USB 调试。

步骤 1：提取 boot.img 文件

1. 确定固件文件类型

如果固件文件是 ZIP 格式：
- 解压文件，检查是否包含 boot.img 文件。
如果固件文件包含 payload.bin，则需使用工具提取。

2. 使用 Payload Dumper 提取 boot.img

下载 Payload Dumper 工具：
- Python 版本。
提取 boot.img：
- 将 payload.bin 放入 Payload Dumper 目录。
- 运行以下命令（Python 版本）：
```
python payload_dumper.py --out output_folder payload.bin
```
- 提取完成后，boot.img 文件将在 output_folder 目录中。

步骤 2：通过 Magisk 修补 boot.img

1. 安装 Magisk APK

将下载的 Magisk APK 文件复制到手机并安装。

2. 修补 boot.img 文件

打开 Magisk 应用。
点击安装 > 选择并修补文件。
选择提取的 boot.img 文件。
Magisk 将生成修补后的文件，命名为 magisk_patched-xxx.img，并保存在手机的 Download 文件夹中。

3. 将修补后的 boot.img 复制到电脑

使用以下 ADB 命令将修补文件复制到电脑：
```
adb pull /sdcard/Download/magisk_patched-xxx.img .
```

步骤 3：通过 Fastboot 刷入修补后的 boot.img

1. 进入 Fastboot 模式

关闭设备电源。
按住 音量下键 + 电源键，直到设备进入 Fastboot 模式。

2. 连接并验证设备

使用以下命令确认设备已连接：

3. 刷入修补后的 boot.img

运行以下命令刷入修补后的 boot 镜像：
```
fastboot flash boot magisk_patched-xxx.img
```

4. 重启设备

刷入完成后重启设备：

步骤 4：验证 Root 权限

1. 安装 Root Checker

下载并安装 Root Checker 应用。

2. 打开 Magisk

确认 Magisk 已安装且运行正常。

使用 Swapper for Root 扩展虚拟内存

1. 安装 Swapper for Root

从 Google Play 商店下载 Swapper for Root 应用。

2. 配置虚拟内存

打开应用并授予 Root 权限。
设置所需的虚拟内存大小（例如，6GB = 6144MB）。
选择存储路径，通常为 /data 或 /cache。
启用 Swap。

3. 验证 Swap 配置

使用以下命令检查 Swap 是否已激活：
```
adb shell cat /proc/swaps
```

常见问题及解决方法

1. boot.img 提取错误

问题：无法在固件文件中找到 boot.img。
解决方法：
- 确保使用正确的固件。
- 更新 Payload Dumper 工具。

2. Magisk 修补问题

问题：Magisk 无法修补 boot 镜像。
解决方法：
- 确保 boot.img 文件有效且未被修改。
- 使用最新版 Magisk。

3. 设备卡在开机界面

问题：刷机后设备卡在启动画面。
解决方法：
1. 刷回原始 boot.img 文件。
2. 通过 Fastboot 清除缓存：
```
fastboot erase cache
```

4. Swapper 无法工作

问题：虚拟内存未激活。
解决方法：
- 确保设备已 Root。
- 检查所选路径的存储空间。