Magisk Install zh_CN - monsterxcn/myBlog GitHub Wiki

此页为 @topjohnwu/Magisk 仓库中 install.md 的简体中文翻译

 

Installation

如果你已经安装了 Magisk，强烈建议 通过 Magisk Manager 使用「直接安装」方式直接升级。下面的教程只针对初始安装。

Getting Started

在你开始之前：

  • 本教程假定你已经了解如何使用 adb 和 fastboot。
  • 你设备的 Bootloader 必须解锁。
  • 在安装 Magisk 之前，请确保删除任何「启动镜像修改（boot image mods）」，如其他 Root 解决方案。最简单的方法是用出厂镜像恢复启动镜像，或者重新刷入一个 未预置 Root 的自定义 ROM。
  • 如果你打算安装自定义内核（custom kernels），请在 Magisk 之后安装。

下载并安装最新版 Magisk Manager，我们使用该 APP 来收集有关你的设备的一些信息。在主界面上，你应该看到以下内容：

特别注意 Ramdisk 的信息，如果结果是 Yes，恭喜你，你的设备非常适合安装 Magisk！但是，如果结果是 No，那么你的设备的启动分区 不包含 ramdisk。这意味着你必须通过一些额外的步骤来使 Magisk 正常工作。

如果你的设备没有 boot ramdisk，请在安装后阅读 Magisk in Recovery 部分。该部分的信息 非 常 重要！。

  • 如果你正在使用三星设备并且 SAR 结果为 Yes，请检查 自己的部分
  • 如果你正在使用华为设备并且 SAR 结果为 Yes，请检查 自己的部分

否则，继续至 Patching Images。

P.S.1 如果你的设备有 boot ramdisk，你也可以用 Custom Recovery 来安装 P.S.2 如果你对 Android 系统如何启动和如何影响 Magisk 感兴趣，请查看 这篇文档

Patching Images

  • 如果你的设备有 boot ramdisk，你需要一个 boot.img 的副本。
  • 如果你的设备 没有 boot ramdisk，你需要一份 recovery.img 的副本。

你应该可以从官方固件包或你的定制 ROM 压缩包（如果使用的话）中解压出你所需要的文件。如果你仍然有问题，请到 XDA-Developers 寻找资源、指南、讨论，或者在你的设备的论坛上寻求帮助。

  • 将启动或恢复镜像复制到你的设备上。

  • 在 Magisk Manager 中按下 Magisk 卡片上的 安装 按钮。

  • 如果你是在修补恢复镜像，请确保在选项中勾选 「Recovery Mode」。

    在大多数情况下，它应该已经被自动勾选。

  • 在方法中选择 「Select and Patch a File」，并且选择原有的启动或恢复映像文件。

  • Magisk Manager 会将镜像文件修补到 [Internal Storage]/Download/magisk_patched.img。

  • 用 ADB 将打好补丁的镜像文件复制到你的电脑上：

    adb pull /sdcard/Download/magisk_patched.img

  • 刷入将打好补丁的启动或恢复镜像至你的设备。

    对于大多数设备，重新启动至 Fastboot 模式并使用命令刷入：

    fastboot flash boot /path/to/magisk_patched.img 或

    fastboot flash recovery /path/to/magisk_patched.img 刷入恢复镜像

  • 重新启动瞧瞧！

Custom Recovery

在某些 Custom Recovery 中，安装可能会失败（这可能看起来像安装成功，但实际上是启动循环）。这是因为 Magisk 安装程序脚本无法正确检测到正确的设备信息或 Recovery 环境不符合 Magisk 安装的预期。如果你面临任何问题，请使用 Patch Images 的方法，因为它保证 100% 可用。由于这个原因，我们不再推荐在现代设备上通过 Custom Recovery 安装 Magisk。Custom Recovery 安装方法的存在主要是为了支持传统设备。

  • 下载 Magisk 安装程序压缩包
  • 重新启动到 Custom Recovery
  • 刷入 Magisk 安装程序压缩包并重新启动
  • 检查 Magisk Manager 是否已经安装。如果没有自动安装，请手动安装 APK 文件。

Magisk in Recovery

如果你的设备启动镜像中没有 ramdisk，Magisk 别无选择只能安装在 Recovery 分区中。对于这些设备，每次想要使用 Magisk 时你必须 重启到 Recovery 模式。

当 Magisk 安装在你的 Recovery 中时，你 不 能 使用 Custom Recovery 来安装或升级 Magisk！ 安装或升级 Magisk 的唯一方法是通过 Magisk Manager。该应用程序将得知你的设备状态，并安装到正确的分区并重新启动到正确的模式。

由于 Magisk 现在劫持了设备的 Recovery，所以有一个机制可以让你在需要的时候 真实地 启动进入 Recovery 模式：这是由 按下恢复模式键组合的时间 来决定的。

每个设备都有自己的组合键来启动到 Recovery 模式，例如 Galaxy S10 是（电源 + Bixby + 音量加）。一次快速的谷歌搜索应该很容易得到你的设备的相关信息。当你按下恢复模式组合键，设备震动并出现闪屏时，释放所有按钮以启动到含 Magisk 的系统。如果你决定启动到真实的 Recovery 模式，继续按着音量加，直到你看到 Recovery 界面。

在 Magisk in Recovery 安装后（从关机开始）：

  • （正常开机）→（无 Magisk 的系统）
  • （恢复模式键组合）→（闪屏）→（松开所有按键）→（含 Magisk 的系统）
  • （恢复模式键组合）→（闪屏）→（音量加保持按下）→（真实的 Recovery 模式）

Sumsung (System-as-root)

如果你的设备 没 有 运行 Android 9.0 或更高版本，你就读错了章节。

安装 Magisk 之前

  • 安装 Magisk 将会 熔断 KNOX
  • 第一次安装 Magisk 需要 一次完整的数据擦除（解锁 Bootloader 时的 data wipe 不包括 在内）。在继续之前，请先备份你的数据。

解锁 Bootloader

在现代三星设备上解锁 Bootloader 有一些注意事项，所以我想这将有所帮助。

  • 在 开发者选项 → OEM 解锁 中允许 Bootloader 解锁。
  • 重启至 Download 模式：将设备关机并按下设备的下载模式键组合（通常是电源 + Bixby + 音量减）。
  • 长按音量加来解锁 Bootloader。这将擦除你的数据并自动重启。

如果你以为 Bootloader 已经完全解锁，其实不然！三星推出了 VaultKeeper，这意味着在 VaultKeeper 明确允许之前 Bootloader 仍然会拒绝任何非官方分区。

  • 进行初始设置。跳过所有步骤，因为稍后安装 Magisk 时数据会被再次清除。在设置过程中将设备连接到互联网。
  • 启用开发者选项，并 确认 OEM 解锁选项存在且为灰色。这意味着 VaultKeeper 服务已经释放了（unleashed）Bootloader。
  • 你的 Bootloader 现在在 Download 模式中接受非官方的镜像。

安装说明

  • 使用 Frija 或 Samloader 直接从三星服务器下载最新的固件压缩包。

  • 解压固件并将 AP tar 文件复制到你的设备上。它通常名为 AP_[device_model_sw_ver].tar.md5。

  • 在 Magisk Manager 中按下 Magisk 卡片上的 安装 按钮。

  • 如果你的设备 没有 boot ramdisk，请确保在选项中勾选 「Recovery Mode」。

    在大多数情况下，它应该已经被自动勾选。

  • 在方法中选择 「Select and Patch a File」，并且选择 AP tar 文件。

  • Magisk Manager 会将整个固件文件修补到 [Internal Storage]/Download/magisk_patched.tar。

  • 用 ADB 将打好补丁的 tar 文件复制到你的电脑上：

    adb pull /sdcard/Download/magisk_patched.tar

    不要 使用 MTP，因为据报告 MTP 会损坏文件。

  • 重新启动到 Download 模式。在电脑上打开 Odin，将 magisk_patched.tar 作为 AP 与原始固件中的 BL、CP 和 CSC（不是 HOME_CSC，因为我们要 擦除数据）一起刷入。这可能需要一些时间（>10 分钟）。

  • Odin 完成后，你的设备会重新启动。你可以继续进行标准的初始化设置。

    如果你卡在了启动循环中，如果答应的话做一次出厂设置。

  • 如果你的设备 没有 boot ramdisk，现在重启到 Recovery 来启动含 Magisk 的 Android 系统（具体在 Magisk in Recovery 里说明）。

  • 虽然 Magisk 已经安装完毕，但仍需要一些额外的设置。请连接到互联网。

  • 安装最新的 Magisk Manager 并打开。它应该会显示一个对话框，要求进行额外的设置。让它完成它的工作，应用程序将自动重新启动你的设备。

  • 瞧！享受 Magisk 吧 😃

补充说明

  • 永远 不要 尝试将 boot 或 recovery 分区恢复到原始状态！这样做很容易使你的设备死机，救砖唯一的办法是进行带有数据擦除的整机 Odin 还原。
  • 要用新的固件升级你的设备时，千万不要 直接使用原版的 AP tar 文件，原因如上所述。使用 Odin 刷机之前 请务必 在 Magisk Manager 中预先修补 AP。
  • 当进行固件升级时，使用 HOME_CSC 来保存数据。使用 CSC 只在初始安装时需要。
  • 千万不要只刷入 AP，否则 Odin 会压缩你的 /data 文件系统。升级的时候要把 AP+BL+CP+HOME_CSC 全部刷入。

Huawei

Magisk 官方不再支持现代华为设备，因为其设备上的 Bootloader 无法解锁，更重要的是它们不遵循标准的 Android 分区方案。下面仅为少数成功解锁了 Bootloader 并真正想要 Root 的华为用户提供一些大致的指导。

使用麒麟处理器的华为设备分区方式与大多数普通设备不同。Magisk 通常安装在设备的 boot 分区，但华为设备没有这个分区。

一般来说，参考 Patching Images，与原来的说明有一些区别:

  • 下载完你的固件压缩包（你可能会在 华为固件数据库 中找到很多）后，你必须用 华为更新提取器 从压缩包提取 UPDATE.APP 中的镜像。（仅限 Windows！）

  • Regarding patching images:

  • 关于修补镜像：

    • 如果你的设备有 boot ramdisk，请修补 RAMDISK.img 以代替 boot.img。
    • 如果你的设备 没有 boot ramdisk，请修补 RECOVERY_RAMDIS.img（这不是打字错误）以代替 recovery.img。

  • 当用 fastboot 刷回镜像时：

    • 如果你修补了 RAMDISK.img，刷入镜像时使用命令 fastboot flash ramdisk magisk_patched.img。
    • 如果你修补了 RECOVERY_RAMDIS.img，刷入镜像时使用命令 fastboot flash recovery_ramdisk magisk_patched.img。