workphone-sdk/sdk/docs/设备启动指南.md

设备启动指南

方式一：Android Studio 模拟器（推荐）

1. 启动Android Studio

open -a "Android Studio"

2. 在Android Studio中：

• 点击右上角 Device Manager 图标
• 选择一个模拟器（如 Pixel 7）
• 点击 ▶️ Play 按钮启动

3. 等待模拟器启动完成（约30秒）

4. 验证连接

adb devices
# 应该看到类似：emulator-5554    device

---

方式二：命令行启动模拟器

1. 设置环境变量

export ANDROID_HOME=~/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools

2. 列出可用模拟器

emulator -list-avds

3. 启动模拟器

emulator -avd <模拟器名称> &

---

方式三：连接真机

1. 开启USB调试

• 设置 → 关于手机 → 连续点击"版本号"7次
• 返回 → 开发者选项 → 开启"USB调试"

2. 连接USB线

3. 验证连接

adb devices
# 应该看到设备序列号

---

方式四：WiFi ADB（无线调试）

1. 在手机上：

• 设置 → 开发者选项 → 无线调试
• 开启"无线调试"
• 记录IP地址和端口（如：192.168.1.100:5555）

2. 在电脑上连接

adb connect 192.168.1.100:5555
adb devices

---

快速测试

设备连接后，运行：

# 安装APP
adb install -r sdk/android-app/app/build/outputs/apk/debug/app-debug.apk

# 启动APP
adb shell am start -n com.workphone.agent/.MainActivity

# 测试语音命令
adb shell input tap 540 1200  # 点击麦克风
# 或点击底部"打开豆包"按钮

---

常见问题

Q: adb devices 显示 "unauthorized"

A: 在手机上点击"允许USB调试"授权

Q: 模拟器启动很慢

A: 首次启动需要下载系统镜像，请耐心等待

Q: 找不到模拟器

A: 在Android Studio中创建新的AVD（Android Virtual Device）

---

下一步

设备连接成功后：

1. 安装工作手机Agent APP
2. 点击麦克风说"打开豆包"
3. 或点击底部快捷按钮