SuperAPI AI 工具集

jugg-android-dev-loop

通用与其它

查看项目

更新于 10-16 08:33

技能介绍

用途:在 Android 项目中驱动开发循环,通过 Jugg CLI 进行增量编译与部署,减少完整 Gradle 构建频率,并支持部署后验证。适用于编辑 Java/Kotlin/XML/layout/AndroidManifest/Gradle 源文件,或用户要求构建、部署、验证 Android 应用时。

主要能力与用法:入口为 python3 {SKILL_DIR}/scripts/jugg.py [--project-dir <path>] <子命令> [选项],可用 help <子命令> 查看帮助。构建命令:compile(仅编译修改源,跳过部署)、deploy(编译并部署到设备)、gradle-build(完整 Gradle 编译回退)、clean-reinstall(清除应用数据并启动设备)、instrument(运行 androidTest)。运行时命令:restart、status(可加 --refresh-changes false、--full-info true)、activity-stack、devices、wait-logs --marker '<regex>'(可配 --tags、--timeout-ms)。UI 交互命令需按需加载 references/cli_manual.md。

流程要点:阶段 0 需收集 projectDir、hasAutoRunEntry、enabledAndroidTest 等上下文;阶段 1 按场景加载参考文档(安装 CLI、androidTest、自动运行入口验证、编译部署)。自动运行入口需用户显式声明全限定方法名(如 com.myapp.Test.run),无法自动发现,未声明应询问用户而非猜测或搜索代码。

限制与规则:先路由场景,不可混用流程;先完成所有源文件编辑再触发一次编译/部署,不要逐文件编译;任何源修改必须通过编译才算完成;构建命令为阻塞式前台调用,需等待进程退出后解析输出,不要后台运行或轮询;编译/部署失败时先读错误、重试最多 3 次,再回退 gradle-build,仍失败可调用 ssh-info(需用户明确同意),仍不明确则停止并询问。缺失信息包括安装步骤细节、CLI 选项完整说明等,需查阅对应参考文档。