# SoundGame — Android 开发环境使用说明

全部软件安装在用户目录，无需 sudo。`source` 环境变量文件后即可使用：

```bash
source /home/ubuntu/SoundGame/env.d/android.sh
```

## 已安装组件

| 组件 | 版本 | 位置 |
|---|---|---|
| JDK (OpenJDK) | 17.0.2 | `tools/jdk17` |
| Android cmdline-tools | latest (15859902) | `tools/android-sdk/cmdline-tools/latest` |
| platform-tools (adb) | 37.0.1 | `tools/android-sdk/platform-tools` |
| Android SDK Platform | android-36 | `tools/android-sdk/platforms/android-36` |
| build-tools | 36.0.0 | `tools/android-sdk/build-tools/36.0.0` |
| ffmpeg / ffprobe（静态） | N-126303 (2026-08-27) | `tools/bin/` |

## 常用命令

```bash
adb devices                          # 查看已连接设备
sdkmanager --list_installed          # 查看已安装 SDK 组件
sdkmanager "platforms;android-36"    # 安装其他组件
ffmpeg -i in.mp3 -c:a aac out.m4a    # 音频转码
```

Gradle 项目可在 `local.properties` 中写：
```
sdk.dir=/home/ubuntu/SoundGame/tools/android-sdk
```

## 真机调试（WSL2 无法直接访问 USB，推荐以下两种方式）

### 方式一：无线调试（推荐，Android 11+）

手机和电脑连同一 Wi-Fi。手机上：开发者选项 → 无线调试。

```bash
# 1. 配对（手机“无线调试”→“使用配对码配对”，会显示 IP:端口 和 6 位配对码）
adb pair 192.168.x.x:37027
# 输入配对码

# 2. 连接（用无线调试首页显示的 IP:端口，注意与配对端口不同）
adb connect 192.168.x.x:43215

# 3. 验证
adb devices
```

Android 10 及以下可先在有 root/电脑的机器上执行 `adb tcpip 5555`，再 `adb connect <手机IP>:5555`。

### 方式二：Windows 侧 adb server（备选）

WSL2 默认看不到 USB 设备。可让 adb server 跑在 Windows 侧：

1. Windows 安装 platform-tools，手机开 USB 调试并连上 Windows，确认 Windows 的 `adb devices` 能看到手机。
2. Windows 上执行：`adb -a -P 5037 nodaemon server`（监听所有网卡）。
3. WSL2 中获取 Windows 主机 IP（`ip route show | awk '/default/ {print $3}'`），然后：
   ```bash
   export ADB_SERVER_SOCKET=tcp:<Windows主机IP>:5037
   adb devices   # 现在走的是 Windows 的 server
   ```

## 备注

- JDK 实际用的是华为云镜像的 Oracle OpenJDK 17.0.2（Adoptium 官方源在本机过慢），对 Gradle/Android 构建完全够用。
- 未修改 `~/.bashrc`；每次新开 shell 需重新 `source env.d/android.sh`。