2.7 KiB
2.7 KiB
本地开发与验证
环境要求
- Windows 10 或兼容开发环境；
- JDK 17；
- Android SDK，包含 API 34 对应平台和构建工具；
- Git；
- PowerShell 7 优先，Windows PowerShell 也可使用。
本机 Android SDK 路径可以由 Android Studio、环境变量或未提交的 local.properties 配置，不要把个人绝对路径提交到业务代码或版本库。
首次检查
从仓库根目录执行：
java -version
.\android\gradlew.bat -p android --version
.\android\gradlew.bat -p android test
确认 Gradle 使用 Java 17。如果依赖下载或 SDK 检查失败，先按错误信息补齐环境，再修改代码。
常用命令
运行 JVM 单元测试：
.\android\gradlew.bat -p android test
构建 Debug APK：
.\android\gradlew.bat -p android assembleDebug
同时验证测试和构建：
.\android\gradlew.bat -p android test assembleDebug
Debug APK 输出到：
android/app/build/outputs/apk/debug/app-debug.apk
也可以先进入 android/，再使用 ./gradlew.bat test 等标准命令。
测试范围
当前 JVM 测试位于 android/app/src/test/java/cn/auto/agent/：
| 测试 | 覆盖重点 |
|---|---|
TaskParserTest |
JSON 解析、字段校验和协议约束 |
TaskSynchronizerTest |
设备名筛选、无效任务统计和入库 |
TaskExecutorTest |
步骤执行、包/Activity、唯一节点和结果 |
TaskExecutorTimeoutTest |
有限超时及相关失败行为 |
只运行某个测试类时，可使用：
.\android\gradlew.bat -p android testDebugUnitTest --tests "cn.auto.agent.TaskParserTest"
交付涉及核心逻辑的改动前，仍应运行完整 test。
真机验证
无障碍节点树、输入法、不同系统版本和目标 App 页面无法完全由 JVM 测试覆盖。涉及 AutoAccessibilityService、Manifest、无障碍配置或目标 App 适配时，至少记录并验证：
- 应用可安装和启动；
- 系统设置中可启用
autoagent无障碍服务； - 前台包名和 Activity 能被正确识别；
- 目标页面的选择器匹配数量符合预期；
- 点击、输入、返回或提取动作返回正确结果；
- 超时和失败不会无限等待。
交付时明确写出真机型号、Android 版本、目标 App/页面和实际验证步骤；没有真机验证时也要明确说明。
文档验证
文档改动至少检查：
- 相对链接指向存在的文件；
- 命令从所写目录可以执行；
- 版本和能力状态与代码一致；
- 示例 JSON 符合协议，并且不会把规划中动作写成已实现。
不需要为了文档改动重复发布 APK，但涉及路径或构建说明时应实际运行对应命令。