# ADB 连接指南

本指南提供了通过 ADB 连接云手机设备的详细说明，支持 **Android 12/15** 和 **Android 13/14** 版本。

## 1. Android 12 / Android 15 云手机ADB连接

### 步骤1：连接云手机IP和端口

使用`adb connect`命令直接连接云手机的IP地址和端口。

```bash
adb connect 172.168.10.1:123456
```

> 将 `172.168.10.1:123456` 替换为您的实际云手机 IP 和端口。


### 第 2 步：使用连接代码进行身份验证

连接成功后，使用连接码进行身份验证。

```bash
adb shell 123456
```

认证成功后，默认进入云手机，可以使用“退出”退出

```bash
exit
```

或者指定设备地址：

```bash
adb -s 172.168.10.1:123456 shell 123456
```

> 注：连接码通常由云手机平台提供。确保输入正确。


## 2. Android 13 / Android 14 / Android 15A / Android 16 云手机ADB连接

对于这些版本，必须建立 SSH 隧道来转发 ADB 端口。这需要两个步骤。

### 第1步：建立SSH隧道（打开第一个CMD窗口）

运行以下 SSH 命令将远程 ADB 端口映射到本地计算机：

```bash
ssh -oHostKeyAlgorithms=+ssh-rsa 10.2.179.250_1763627294587@107.151.131.2 -p 1824 -L 9897:adb-proxy:14566 -Nf
```

> 注意事项：
- 将命令中的用户名、IP 和端口替换为您的实际配置。
- 当提示输入密码时，粘贴 SSH 密码并按 Enter。
- 如果成功，该命令不会产生任何输出，表明隧道正在后台运行。



### 步骤 2：连接到本地 ADB 端口（打开第二个 CMD 窗口）

在新窗口中执行ADB连接命令：

```bash
adb connect localhost:9897
```

成功输出示例：

```
connected to localhost:9897
```

## 完整的工作流程示例

### 1.第一个CMD窗口（SSH隧道）：

```bash
ssh -oHostKeyAlgorithms=+ssh-rsa 10.2.179.250_1763627294587@107.151.131.2 -p 1824 -L 9897:adb-proxy:14566 -Nf
```

接下来输入SSH连接密码

### 2.第二个CMD窗口（ADB连接）：

```bash
adb connect localhost:9897
```

## 验证连接状态

运行以下命令检查设备是否已连接：

```bash
adb devices
```

预期输出：

```
List of devices attached
localhost:9897     Device
```

## 常用ADB命令参考

| 命令 | 描述 |
|  --- | --- |
| `adb devices` | 列出已连接的设备 |
| `adb shell` | 进入设备外壳终端 |
| `adb shell pm list packages` | 列出已安装的应用程序 |
| `adb install app.apk` | 安装APK文件 |
| `adb uninstall package.name` | 卸载应用程序 |
| `adb reboot` | 重启设备 |


## 重要提示

- 确保您已安装 [Android SDK 平台工具](https://developer.android.com/studio/releases/platform-tools) 并配置环境变量。
- Android 13/14/15A 的 SSH 隧道方法已加密且安全 — 建议使用。
- 如果连接超时，请检查网络设置、防火墙规则和端口配置。
- 连接前请务必确认云手机已开机并开启ADB访问。


按照以下步骤成功连接云手机以执行 ADB 调试和自动化任务。