ADB

Android 调试桥 (adb) 是一种功能多样的命令行工具，可让您与设备进行通信。adb 命令可用于执行各种设备操作，例如安装和调试应用。

• 官方资料
• 官方资料

::: tip 您可以使用 Shizuku 将 ADB 权限共享给其他应用

有关 Shizuku 启动的方法，请参考 Shizuku 的《用户手册》。 :::

要使用 adb，请下载 adb 工具。

无线调试 (传统方法)

传统方法的无线调试需要 Root，或者其他设备辅助才能开启。

1. 将手机打开 ADB 调试，并与电脑连接，等待驱动自动安装成功。
2. 电脑安装 Platform-Tools，然后打开终端，输入 adb tcpid <端口>，例如 adb tcpid 5555
   （重新启动 adbd，在 TCP上 监听 5555 端口）。
3. 将手机与电脑处于统一局域网下，电脑继续执行 adb connect <手机内网IP>[:端口]，例如 adb connect 192.168.1.666:5555
   （假设手机 IP 为 192.168.1.666，并且已监听 5555 端口）
   （通过 TCP/IP 连接到一个设备[默认端口=5555]）
4. 至此，您的设备已通过WIFI连接到电脑。

::: tip 您可以使用 WADB 在有 Root 的手机上一键进行 1 - 2 步骤。 :::

无线调试 (新方法)

通过无线调试新方法适用于 Android 11 （API 级别 30）或以上版本。这种启动方式无需连接电脑。由于系统限制，每次重新连接 WIFI 后都需要重新开启。

例如，您可以将可调试应用部署到多台远程设备，而无需通过 USB 实际连接设备。这样就可以避免常见的 USB 连接问题，例如驱动程序安装方面的问题。

::: tip 需要 ADB 30.0.0 或者以上版本。您可以输入以下代码查看 ADB 版本

$ adb --version // [!code focus]
Android Debug Bridge version 1.0.41
Version 28.0.2-debian
Installed as /usr/lib/android-sdk/platform-tools/adb

::: 敬请期待

ADB 工具 ( adb.exe )

ADB 工具下载与安装

因为 ADB 工具是 Platform-Tools 的一部分，所以您需要下载 Platform-Tools。

有关更多信息，请参阅 实用工具 > Platform-Tools > Platform-Tools 下载与安装。

Linux 系统可通过 apt 等包管理工具安装

::: code-group

sudo apt update
sudo apt upgrade
sudo apt install adb

:::

::: tip Android Studio 会自动下载 Platform-Tools。如果您曾今使用过 Android Studio，则可能无需手动下载此工具。 :::

检测工具是否被正常安装

1. 打开终端，在 Windows 中为 Windows 终端 、终端 、命令提示符（也叫 cmd）
2. 运行命令 adb version ，如果弹出了版本信息，则说明安装成功

::: code-group

C:\Users\USER>adb version // [!code focus]
Android Debug Bridge version 1.0.41
Version 33.0.0-8141338
Installed as C:\Program Files (x86)\platform-tools\adb.exe

PS C:\Users\USER> adb version // [!code focus]
Android Debug Bridge version 1.0.41
Version 33.0.0-8141338
Installed as C:\Program Files (x86)\platform-tools\adb.exe

user@DESKTOP-93UT1LQ:~$ adb version // [!code focus]
Android Debug Bridge version 1.0.41
Version 28.0.2-debian
Installed as /usr/lib/android-sdk/platform-tools/adb

:::

实际的版本号与示例不匹配没关系，大部分情况不影响使用。

常见用法

ADB 安装软件

常见用法：adb install -r 我的软件.apk（重新安装 我的软件.apk 安装包并保留数据。）

使用 ADB 为安卓设备安装软件

请阅读 快速开始 > 安装第三方软件：安装电脑或其他设备上的软件。

ADB sideload

使用 ADB 刷入刷机包

请阅读 常用工具 > 刷入 ROM：ADB Sideload

Awesome ADB | 令人惊叹的 ADB

权限分享/接收

• Shizuku：让你的应用直接使用系统 API
• Shizuku-API：Shizuku 和 Sui 的API和开发者指南。

相关链接

• 常用工具 > Platform-Tools

参考链接

• 用户手册 - Shizuku