Magisk Manager

快速步骤

  1. 下载适用于你电脑的 Google SDK Platform-Tools 并解压。
  2. 在手机的开发者选项中打开 USB 调试。
  3. 在 platform-tools 文件夹中打开终端,运行 adb devices。
  4. 手机询问是否允许 USB 调试时,点击允许。
  5. 要测试 fastboot,请先运行 adb reboot bootloader,再运行 fastboot devices。

什么是 ADB 和 fastboot?

ADB(Android 调试桥)在 Android 运行时与手机通信。你可以用它复制文件、安装应用,以及把手机重启到其他模式。

Fastboot 与手机的 Bootloader 通信。你可以用它解锁 Bootloader,以及刷入映像,例如 Magisk 修补过的 boot 映像。

两者都包含在 Google 免费提供的 SDK Platform-Tools 工具包中。请只从 Google 下载。其他网站上的“Minimal ADB”之类的工具包往往版本过旧,有些还捆绑了你不想要的软件。

在 Windows 上安装 ADB 和 fastboot

  1. 下载 Platform-Tools

    打开 Google 的 Platform-Tools 页面,下载 SDK Platform-Tools for Windows,并接受条款。

  2. 解压

    把 zip 文件解压到一个较短的路径,例如 C:\platform-tools。路径过长或文件夹名称中含有特殊字符,都可能导致出错。

  3. 在该文件夹中打开终端

    在文件资源管理器中打开该文件夹,点击地址栏,输入 cmd 并按 Enter 键,就会在该文件夹中打开命令提示符。在 PowerShell 或 Windows 终端中,每条命令前都要加上 .\,例如 .\adb devices。

  4. 安装 USB 驱动

    Windows 通常会自动安装驱动。如果没有,Pixel 手机请安装 Google USB 驱动,其他品牌请安装手机厂商提供的 USB 驱动。

  5. 可选:添加到 PATH

    要在任意文件夹中运行 adb,请在 Windows 中搜索编辑系统环境变量,打开环境变量,选择 Path,点击编辑,然后添加 C:\platform-tools。完成后请打开一个新的终端窗口。

在 macOS 上安装 ADB 和 fastboot

最简单的方法是使用 Homebrew:

brew install --cask android-platform-tools

如果没有 Homebrew,请从 Google 的 Platform-Tools 页面下载 SDK Platform-Tools for Mac 并解压,然后在 platform-tools 文件夹中打开“终端”,每条命令前都加上 ./,例如 ./adb devices。Mac 不需要 USB 驱动。

在 Linux 上安装 ADB 和 fastboot

大多数发行版都提供这两个工具的软件包:

发行版命令
Debian、Ubuntu、Linux Mintsudo apt install adb fastboot
Fedorasudo dnf install android-tools
Arch Linuxsudo pacman -S android-tools

这些软件包的版本可能落后于 Google 的发布。如果 fastboot 在较新的手机上出错,请从 Google 的 Platform-Tools 页面下载 SDK Platform-Tools for Linux,并在解压后的文件夹中运行 ./adb 和 ./fastboot。

如果 adb devices 显示 no permissions,说明你的用户无权通过 USB 访问手机。在 Debian 和 Ubuntu 上,android-sdk-platform-tools-common 软件包会添加解决这个问题的规则。安装后请拔下手机,再重新连接。

连接手机

  1. 打开 USB 调试

    先打开开发者选项(在设置 → 关于手机中连续点击版本号七次),然后在开发者选项中打开 USB 调试。

  2. 连接手机并允许这台电脑

    用支持数据传输的 USB 数据线连接手机,有些廉价的数据线只能充电。运行:

    adb devices
    

    手机会询问是否允许 USB 调试。勾选一律允许使用这台计算机进行调试,然后点击允许。

  3. 检查结果

    再次运行 adb devices。列表中应该会出现你手机的序列号,后面显示 device。如果显示的是 unauthorized,请解锁手机屏幕并接受提示。

  4. 测试 fastboot

    重启到 Bootloader,检查 fastboot 能否识别手机:

    adb reboot bootloader
    
    fastboot devices
    

    运行 fastboot reboot 即可回到 Android。

使用 Magisk 时会用到的命令

命令作用
adb devices列出已连接的手机
adb reboot bootloader把手机重启到 Bootloader(fastboot 模式)
adb pull /sdcard/Download/file.img把文件从手机复制到电脑
adb push file.img /sdcard/Download/把文件从电脑复制到手机
fastboot devices列出处于 fastboot 模式的手机
fastboot flash init_boot file.img把映像刷入分区,这里是 init_boot
fastboot reboot把手机重启到 Android

完整的 Root 步骤见主教程:如何用 Magisk Root 手机。

常见的 ADB 和 fastboot 错误

adb devices 什么都不显示。 换一根数据线或换一个 USB 接口试试,最好直接插在电脑上,而不是通过 USB 集线器。在手机上,把 USB 模式设为文件传输。在 Windows 上,重新安装 USB 驱动。

设备显示为“unauthorized”。 解锁手机,并在是否允许 USB 调试提示中点击允许。如果没有出现提示,请在开发者选项中点击撤消 USB 调试授权,然后重新连接。

“'adb' 不是内部或外部命令,也不是可运行的程序或批处理文件”。 Windows 找不到 adb。请在 platform-tools 文件夹中打开终端,或者把这个文件夹添加到 PATH。在 PowerShell 中,请输入 .\adb。

在 Mac 或 Linux 上提示“command not found: adb”。 请在 platform-tools 文件夹中运行 ./adb,或者用 Homebrew 或发行版的软件包管理器安装这些工具。

ADB 正常,但 fastboot 什么都不显示,或提示“waiting for any device”。 确认手机显示的是 Bootloader 界面。在 Windows 上,请在手机处于 Bootloader 时打开设备管理器:如果有带警告图标的设备,请更新它的驱动,并选择 Android Bootloader Interface。

“Flashing is not allowed in Lock State”。 Bootloader 仍处于锁定状态。请先解锁。

常见问题解答

使用 ADB 需要安装 Android Studio 吗?

不需要。Google 的 SDK Platform-Tools 是一个单独的小型下载包,里面就有 adb 和 fastboot。你不需要 Android Studio,也不需要完整的 Android SDK。

使用 ADB 安全吗?

安全。ADB 和 fastboot 是 Google 的官方工具。开启 USB 调试后,你批准过的电脑就可以控制你的手机,所以只允许你信任的电脑,用完后请关闭 USB 调试。

可以通过 Wi-Fi 使用 ADB 吗?

可以。Android 11 及更高版本的开发者选项中有“无线调试”。不过在几乎所有手机上,fastboot 都需要 USB 数据线,所以安装 Magisk 时请使用数据线。

为什么要使用最新版 Platform-Tools?

旧版 fastboot 在较新的手机上可能会出错。Google 会定期更新 Platform-Tools,所以请下载最新版本,不要使用从其他网站获取的副本。