SmartDust Docker镜像文档

1. 镜像概述和主要用途

SmartDust是一个用于构建私有Android开发设备云的Docker镜像。它允许开发者将物理Android设备集中管理，构建可供团队共享的设备池，并支持与CI/CD系统集成，实现多设备并行开发、测试和部署。

2. 核心功能和特性

• 集中设备管理：通过单一页面或任何IDE控制所有连接的Android开发设备
• 批量应用部署：将APK拖放至主设备，一键在所有连接设备上安装并启动应用
• 并行测试执行：支持多设备同时运行测试（手动触发或集成Jenkins、Travis等CI服务器）
• 即时调试能力：在异常设备上快速设置断点调试，无需离开开发环境
• 设备共享机制：支持开发团队共享设备资源，提高设备利用率
• CI/CD集成：无缝对接持续集成/持续部署系统，自动化测试和发布流程

3. 使用场景和适用范围

• 开发团队协作：中小型开发团队共享有限的Android设备资源，避免设备争抢
• 多设备兼容性测试：同时在不同品牌、型号、系统版本的Android设备上验证应用兼容性
• CI/CD自动化流程：集成到Jenkins、Travis等CI/CD pipeline，实现提交后自动多设备测试
• 远程开发支持：允许开发者通过浏览器远程访问和控制设备，无需物理接触
• 教学/演示场景：讲师或演示者通过主设备同步控制多台演示设备

4. 使用方法和配置说明

4.1 快速启动

4.1.1 本地访问部署

通过以下命令在本地启动SmartDust服务：

bash
docker run -d --privileged --name=smartdust -p 7000-7500:7000-7500 -v /dev/bus/usb:/dev/bus/usb smartdust/smartdust

启动后，在浏览器中访问 localhost:7100 即可打开管理界面。

4.1.2 外部网络访问部署

若需从其他计算机访问SmartDust服务，需指定主机公网IP：

bash
docker run -d --privileged --name=smartdust -e PUBLIC_IP=<你的IP地址> -p 7000-7500:7000-7500 -v /dev/bus/usb:/dev/bus/usb smartdust/smartdust

启动后，在浏览器中访问 <你的IP地址>:7100 即可打开管理界面。

4.2 配置参数说明

4.3 设备连接步骤

1. 启用设备开发者选项：在Android设备上依次进入「设置 > 关于手机」，连续点击「版本号」7次启用开发者选项
2. 开启USB调试：进入「开发者选项」，启用「USB调试」开关
3. 物理连接设备：通过USB线将设备连接至运行SmartDust的主机
4. 信任调试授权：在设备上弹出的「USB调试授权」窗口中，勾选「始终允许从此计算机」并点击「允许」
5. 设备识别排查：若浏览器界面未显示设备，尝试关闭再重新开启USB调试开关
6. 选择设备控制：在浏览器界面点击设备名称，即可开始管理；可指定一台主设备（Master Device）控制所有其他连接设备

5. 注意事项

• 主机需安装USB设备驱动，确保Android设备能被正确识别
• 设备连接后需在首次授权时允许SmartDust的调试密钥，否则无法建立连接
• 多设备同时操作时建议使用稳定的USB hub，避免供电不足导致设备断开
• CI/CD集成时需确保CI服务器能访问SmartDust服务端口（7000-7500）

更多信息请访问网站：smartdus