SuperAPI AI 工具集

android-deploy-usb

部署与运维

查看项目

更新于 10-15 21:09

技能介绍

用途:把 Android 应用构建后直接安装到通过 USB 连接的设备上,是开发期间在真机测试的快速方式。当用户要求“部署到 Android”“在设备上安装应用”“构建并部署 Android”“推送到设备”或提到在实体 Android 设备上测试时可调用。

主要能力:脚本会依次检查设备连接(adb devices)、用 ./gradlew assembleDebug 构建 APK、用 adb install -r app/build/outputs/apk/debug/app-debug.apk 安装、再用 adb shell am start 启动应用。首次构建约 10-30 秒(需下载依赖),增量构建约 2-5 秒。

使用方式:前置条件包括设备通过 USB 连接、开启 USB 调试与开发者模式、安装 ADB(macOS 可用 brew install android-platform-tools)、设备已授权调试(接受 RSA 密钥),并设置 JAVA_HOME,例如 export JAVA_HOME="/opt/homebrew/opt/openjdk"。随后进入含 build.gradle.kts 的 Android 应用目录,运行 ./install-device.sh。

适用场景:在真实 Android 硬件上快速迭代测试。

限制与常见问题:脚本按特定应用包名配置(如 com.miso.noobtest),不同应用包名在 build.gradle.kts 中不同;macOS 上用 Homebrew 安装 Java 时,运行 Gradle 前必须设置 JAVA_HOME。若提示 no devices found,需开启 USB 调试、接受授权、尝试 adb kill-server && adb start-server 并确认数据线支持数据传输;若提示 Unable to locate a Java Runtime,需设置 JAVA_HOME 或安装 OpenJDK;若出现 INSTALL_FAILED_UPDATE_INCOMPATIBLE,可先 adb uninstall 对应包名再安装;若 device unauthorized,需在设备上接受 RSA 授权;若 adb: command not found,需安装 Android platform tools。其他细节暂未提供。