workphone-sdk/sdk/一键启动.md

🚀 一键启动工作手机Agent

方式一：使用启动脚本（推荐）

cd sdk
./scripts/run_app.sh

脚本会自动：

1. ✅ 检查设备连接
2. ✅ 安装APP
3. ✅ 启动APP

---

方式二：手动启动

1. 启动设备

选项A：Android Studio模拟器

# 打开Android Studio
open -a "Android Studio"

# 然后：Device Manager → 选择模拟器 → 点击 ▶️ Play

选项B：连接真机

• 开启USB调试
• 连接USB线
• 授权此电脑

2. 验证设备

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

3. 安装并运行

cd sdk

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

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

---

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

1. 手机开启无线调试

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

2. 连接

adb connect 192.168.1.100:5555
adb devices

3. 运行脚本

cd sdk
./scripts/run_app.sh

---

测试功能

APP启动后：

1. 语音控制

   • 点击蓝色麦克风按钮
   • 说："打开豆包"
   • APP会自动执行

2. 快捷按钮

   • 点击底部"打开豆包"按钮
   • 立即打开豆包应用

3. 其他命令

   • "返回" - 返回上一页
   • "截图" - 截取屏幕
   • "向上滑" - 向上滑动
   • "回到桌面" - 返回桌面

---

常见问题

Q: adb devices 显示 "unauthorized"

• 在手机上点击"允许USB调试"

Q: 找不到设备

• 检查USB线连接
• 确认USB调试已开启
• 重启ADB: adb kill-server && adb start-server

Q: APP安装失败

• 卸载旧版: adb uninstall com.workphone.agent
• 重新安装

---

下一步

设备连接后，运行：

cd sdk
./scripts/run_app.sh