mcpField
O
ohos-app-build-debug

ohos-app-build-debug

github.com/openharmonyinsight开发3591 次安装11 周前更新
代码仓库

关于 ohos-app-build-debug

用于构建、安装、启动和调试 HarmonyOS/OpenHarmony 应用的技能。随附的 Python 脚本可检测 DevEco Studio 环境，并支持设备截图和崩溃堆栈解析。

主要功能

  1. 01使用 hvigorw 构建 OHOS 应用
  2. 02将 HAP 文件安装到设备
  3. 03启动已安装的应用
  4. 04采集设备截图
  5. 05解析崩溃堆栈
  6. 06检测 DevEco Studio 工具与环境

适用场景

  1. 01构建 OHOS 应用并部署到设备
  2. 02启动已安装应用进行测试
  3. 03截图验证应用行为
  4. 04从文件或文本分析崩溃堆栈

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openharmonyinsight/openharmony-skills --skill ohos-app-build-debug

安装后在 Claude Code 中输入/ohos-app-build-debug确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
command-reference.md
troubleshooting.md
scripts/
build.py
env_detector.py
install.py
launch.py
ohos_utils.py
parse_crash.py
screenshot.py
test_env.py

详细介绍

OHOS 应用构建与调试

何时使用此技能

当用户需要处理 HarmonyOS/OpenHarmony 应用时，请使用此技能：

  • 构建：“构建我的 OHOS 应用”、“编译项目”、“运行 hvigorw”
  • 安装：“安装此 HAP”、“部署到设备”、“将应用安装到设备”
  • 启动：“启动应用”、“启动应用程序”、“在设备上运行”
  • 调试：“截取屏幕截图”、“解析崩溃堆栈”、“调试崩溃”
  • 环境：“检查 DevEco Studio”、“显示 SDK 路径”、“验证工具”、“检测环境”

快速入门

构建、安装并启动 OHOS 应用：

# Run scripts from skill directory
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

随附资源

此技能在 scripts/ 中包含可执行脚本，可自动检测 DevEco Studio 环境：

脚本用途
build.py使用 hvigorw 构建 OHOS 应用
install.py将 HAP 文件安装到已连接的设备
launch.py启动已安装的应用
screenshot.py截取设备屏幕截图
parse_crash.py使用 hstack 解析崩溃堆栈
env_detector.py检测 DevEco Studio 和工具
ohos_utils.py共享实用函数

详细命令参考请参阅 references/command-reference.md。

常见工作流

构建并安装
# 1. Check environment
python3 $SKILL_DIR/scripts/env_detector.py

# 2. Build the application
python3 $SKILL_DIR/scripts/build.py

# 3. Install to device (output from build.py shows HAP path)
python3 $SKILL_DIR/scripts/install.py -f entry/build/default/outputs/default/entry-default-signed.hap

# 4. Launch the app
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
调试工作流
# Launch app
python3 $SKILL_DIR/scripts/launch.py

# Take screenshot to verify
python3 $SKILL_DIR/scripts/screenshot.py -o ./screenshots
崩溃分析
# Parse crash stack from file
python3 $SKILL_DIR/scripts/parse_crash.py -f crash.txt

# Parse from string
python3 $SKILL_DIR/scripts/parse_crash.py -c "stack trace here"

工作原理

自动检测环境

所有脚本都会自动检测 DevEco Studio 的安装位置并配置环境：

  1. 检测 DevEco Studio

    • Windows：C:\Program Files\Huawei\DevEco Studio\
    • macOS：/Applications/DevEco-Studio.app/
    • Linux：~/DevEco-Studio/ 或 /opt/DevEco-Studio/

  2. 工具链配置

    • 将 JAVA_HOME 设为 DevEco 随附的 JBR
    • 将 SDK 工具添加到 PATH
    • 配置 HDC_SERVER_PORT=7035
    • 缓存检测结果 24 小时

  3. 自动检测的工具

    • 核心工具：hdc、hvigorw、java
    • LLVM：clang、clang++、lld、llvm-*
    • 性能分析器：hiprofiler、hiperf
    • 其他：hstack、ohpm、idl、restool、syscap_tool

响应指南

协助用户进行 OHOS 开发时：

  1. 定位技能目录

    • 将 $SKILL_DIR 替换为实际的技能安装路径
    • 常见位置：~/.claude/skills/ohos-app-build-debug 或项目专用路径

  2. 执行脚本

    • 使用绝对路径或相对路径调用 scripts/ 目录中的 Python 脚本
    • 运行脚本前，始终先切换到 OHOS 项目目录

  3. 首先显示环境信息

    • 首次构建时运行 env_detector.py，显示工具可用情况

  4. 提供单行命令

    • 在适当情况下组合构建、安装和启动命令，方便用户使用

  5. 显示实际命令

    • 显示正在执行的 hvigorw/hdc 命令，确保过程透明

  6. 妥善处理错误

  7. 利用项目上下文

    • 根据项目结构自动检测包名和路径

错误处理

如果未检测到 DevEco Studio：

  • 确认已安装 DevEco Studio
  • 检查标准安装路径
  • 设置 DEVECO_STUDIO_PATH 环境变量

如果设备未连接：

  • 检查 USB 线缆连接
  • 确认设备已启用 USB 调试
  • 按提示在设备上授权 USB 调试

详细故障排查信息请参阅 references/troubleshooting.md。

前置条件

  • DevEco Studio 3.1+（推荐 4.0+）
  • OHOS 设备，并已启用 USB 调试
  • Python 3.7+（用于运行脚本）

下载 DevEco Studio：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-download

评论

支持 Markdown