SuperAPI AI 工具集

ohos-app-build-debug

编程与开发

查看项目

更新于 10-16 07:28

技能介绍

用途:面向 HarmonyOS/OpenHarmony 应用开发,覆盖构建、安装、启动与调试流程,适合需要编译项目、部署 HAP 到设备、运行应用、截图验证或分析崩溃堆栈的场景。

主要能力:技能在 scripts/ 目录提供可执行脚本,自动检测 DevEco Studio 环境。build.py 使用 hvigorw 构建应用;install.py 将 HAP 安装到已连接设备;launch.py 启动已安装应用;screenshot.py 截取设备屏幕;parse_crash.py 借助 hstack 解析崩溃堆栈;env_detector.py 检测 DevEco Studio 与工具链;ohos_utils.py 为共享工具函数。

使用方式:先运行 python3 $SKILL_DIR/scripts/env_detector.py 检查环境,再执行 python3 $SKILL_DIR/scripts/build.py 构建,随后用 python3 $SKILL_DIR/scripts/install.py -f entry/build/default/outputs/default/entry-default-signed.hap 安装,最后 python3 $SKILL_DIR/scripts/launch.py 启动。也可组合为一行命令:python3 $SKILL_DIR/scripts/build.py && python3 $SKILL_DIR/scripts/install.py -f $(find entry/build -name "*.hap" | head -1) && python3 $SKILL_DIR/scripts/launch.py。调试时可用 screenshot.py -o ./screenshots 截图,用 parse_crash.py -f crash.txt 或 -c "stack trace here" 解析崩溃。

环境与限制:脚本会自动检测 DevEco Studio 安装路径(Windows、macOS、Linux 常见位置),配置 JAVA_HOME、SDK 工具 PATH 与 HDC_SERVER_PORT=7035,并缓存检测结果 24 小时。前置条件为 DevEco Studio 3.1+(推荐 4.0+)、开启 USB 调试的 OHOS 设备、Python 3.7+。若未检测到 DevEco Studio,可设置 DEVECO_STUDIO_PATH 环境变量;设备未连接时需检查 USB 连接与调试授权。详细命令参考见 references/command-reference.md,故障排查见 references/troubleshooting.md。