用途:调试 HarmonyOS ArkWeb(WebView)应用,包括启动调试会话、连接 Chrome DevTools、检查 WebView 控制台与网络请求、排查连接问题,以及配合 MCP 进行 WebView 自动化测试。
主要能力:技能内置 scripts/ 目录下的调试脚本,start-debug.sh(macOS/Linux)、start-debug.py(跨平台 Python)、start-debug.bat(Windows)。脚本会自动检测 DevEco Studio 安装、配置 hdc 等工具环境、查找 HarmonyOS 工程配置、连接设备并创建端口转发,最后在 http://127.0.0.1:9222 打开 Chrome DevTools。脚本还会动态定位 webview_devtools socket 以应对 PID 变化,并处理启动等待与重试时序。
使用方式:在 HarmonyOS 工程目录下运行 $SKILL_DIR/scripts/start-debug.sh,可用 --package com.example.app 指定包名。可与 ohos-app-build-debug 技能配合,先构建、安装、启动应用,再启动调试。配置 Chrome DevTools MCP 后,可由 Claude 自动执行 WebView 测试。
限制与前提:需要 DevEco Studio 3.1+(推荐 4.0+)或 PATH 中的 hdc、开启 USB 调试的 HarmonyOS 设备、Python 3.8+(使用 py 脚本时)以及 Chrome/Chromium。应用必须在 aboutToAppear() 中调用 webview.WebviewController.setWebDebuggingAccess(true),且需在 Web 组件渲染前启用。常见问题包括 socket 未找到(需等待 10-15 秒)、端口占用、设备未连接或 hdc 未找到。具体收费、价格与平台支持范围资料暂未提供。