> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/chinese-documentation/yun-shou-ji/connect-to-a-cloud-phone-with-adb.md).

# 使用ADB连接到云手机

在 Cloud Phones → ⋮ → 启用 ADB 中为云手机打开 ADB，复制 adb 连接命令并从计算机上的终端连接。

进入 **Cloud Phones**，点击手机旁边的三点图标 (⋮)，然后点击 **Enable ADB**。当手机运行时，再次点击 ⋮ 图标并点击 **Copy ADB command**，然后将命令粘贴到终端中。

ADB（Android Debug Bridge）是 Android 的开发者命令行工具。通过它，您可以安装应用程序、运行 shell 命令并将 Android 自动化工具连接到云手机，就像通过电缆连接到计算机的手机一样。您需要在计算机上安装来自 Google 的 Android SDK Platform-Tools 的 `adb` 工具。

### 打开 ADB

{% stepper %}
{% step %}

#### 打开手机菜单

点击左侧菜单中的 **Cloud Phones**。点击您要连接的手机旁边的三点图标 (⋮)。
{% endstep %}

{% step %}

#### 启用 ADB

点击 **Enable ADB**。消息确认“ADB 成功启用”。

**Enable ADB** 在手机开机或关机时提供。在手机仍在设置、启动、重置或切换其 Android 版本时不提供。
{% endstep %}
{% endstepper %}

当您再次关闭并打开手机时，ADB 保持开启状态。要关闭它，请打开 ⋮ 菜单并点击 **Disable ADB**。这也会关闭计算机上的本地 ADB 连接。

### 复制 ADB 命令

在您可以连接之前，手机必须是**运行中**的。如果它关闭，请先打开。

有两种方法可以复制命令：

* 点击手机旁边的 ⋮ 图标，然后点击 **Copy ADB command**。
* 点击列表中手机的 **ADB Address** 列。它显示为 **Copy** 直到连接打开，然后显示本地地址。

Incogniton 将类似 `adb connect 127.0.0.1:6555` 的命令复制到您的剪贴板，并显示已复制的消息。**Copy ADB command** 仅在手机运行且 ADB 启用时出现。

### 从终端连接

打开终端（命令提示符、PowerShell 或终端），粘贴命令并按 Enter：

```
adb connect 127.0.0.1:6555
```

在 `adb` 报告已连接后，云手机会显示在 `adb devices` 中，您可以像使用其他 Android 设备一样使用它，例如 `adb shell` 或 `adb install app.apk`。

### 连接原理

您永远不会连接到云手机自己的地址。Incogniton 在您的计算机上打开一个本地端口，`127.0.0.1:<port>`（端口在 6555 到 6654 之间），并将连接安全地中继到您的手机。这就是地址总是以 `127.0.0.1` 开头的原因。

* 只要手机运行且 ADB 启用并且 Incogniton 打开，本地端口就保持打开状态。当您关闭手机、禁用 ADB、重置手机或注销时，端口关闭。
* 地址仅在运行 Incogniton 的计算机上有效。其他计算机无法使用它。
* 来自同一计算机上其他用户帐户的连接被拒绝。只有在您自己的计算机帐户下运行的程序才能使用该端口。
* 每次手机启动时，请再次复制命令：端口号可能不同。

{% hint style="warning" %}
ADB 赋予对手机的完全控制权。仅在需要时启用它，并在完成后禁用它。
{% endhint %}

### 谁可以使用 ADB

在团队中，打开或关闭 ADB 以及复制 ADB 命令需要对该手机具有 **Manage cloud phones (edit, proxy, reset, Android version, ADB, root, apps, automation, move)** 权限。请参阅云手机的[团队权限](https://docs.incogniton.com/documentation/chinese-documentation/yun-shou-ji/manage-cloud-phones.md#team-permissions)。

### 当连接不起作用时

* **“ADB 访问 … 被拒绝。检查手机是否开启且 ADB 已启用。”** 手机关闭或 ADB 被关闭。请打开手机，检查 ADB 是否启用并再次复制命令。
* **“无法为 … 打开本地 ADB 端口”** Incogniton 无法为手机打开本地端口。请再次尝试 **Copy ADB command**。
* **“打开的 ADB 连接太多。关闭一些然后重试。”** 使用 `adb disconnect` 断开您不再使用的设备。
* **“无法访问 Incogniton ADB 服务。adb 不断重试。”** 您的计算机目前无法访问 ADB 服务。检查您的互联网连接；`adb` 会自行重新连接。

您还可以从脚本中获取本地地址：请参阅[从脚本和 AI 客户端控制云手机](https://docs.incogniton.com/documentation/chinese-documentation/yun-shou-ji/control-cloud-phones-from-scripts.md)。

{% hint style="info" %}
如果您对云手机上的 ADB 有任何疑问，请随时联系我们的[支持部门](https://incogniton.com/contact/)。
{% endhint %}
