One-click install
npx skills add https://github.com/openharmonyinsight/openharmony-skills --skill arkweb-app-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arkweb-app-debug
Source: https://github.com/openharmonyinsight/openharmony-skills/tree/main/skills/arkweb-app-debug
Command: npx skills add https://github.com/openharmonyinsight/openharmony-skills --skill arkweb-app-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Debugging HarmonyOS ArkWeb (webview) apps is hard because you need reliable device connectivity, DevTools port forwarding, and a way to inspect console, network, and web elements.

Core Features & Use Cases

  • ArkWeb DevTools Debugging: Start a debugging session for an ArkWeb app and connect Chrome DevTools via the Chrome DevTools Protocol.
  • Automatic Device & Socket Setup: Detect the HarmonyOS project configuration (package name), connect to the device, find the webview devtools socket, and create localhost port forwarding.
  • Inspection & Troubleshooting: Inspect webview elements, console output, and network activity, and troubleshoot common issues like missing sockets or failed DevTools connections.

Example: when a webview page fails to load or logs errors, use this skill to connect DevTools, inspect the failing DOM/network calls, and iterate quickly until the issue is resolved.

Quick Start

Start an ArkWeb debugging session from your HarmonyOS project folder by running $SKILL_DIR/scripts/start-debug.sh.

Frequently Asked Questions about arkweb-app-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug an ArkWeb webview using Chrome DevTools?▼

To debug an ArkWeb webview using Chrome DevTools, run the bundled start-debug script from your HarmonyOS project folder to automatically detect the package, establish HDC port forwarding, and expose the local DevTools endpoint for inspection.

Why does my Chrome DevTools connection fail to find the ArkWeb debugging socket?▼

Your Chrome DevTools connection fails to find the ArkWeb debugging socket when automatic device detection or HDC port forwarding is interrupted, which this skill resolves by automatically detecting the correct webview devtools socket and creating localhost port forwarding.

Can I inspect network requests and console logs in a HarmonyOS webview?▼

Yes, you can inspect network requests and console logs in a HarmonyOS webview by connecting Chrome DevTools through the Chrome DevTools Protocol via HDC port forwarding to examine webview elements and network activity.

Does this ArkWeb debugging approach support automated web testing?▼

Yes, this ArkWeb debugging approach supports automated web testing by exposing a local DevTools endpoint that allows MCP-based automated web testing frameworks to connect and execute tests through the Chrome DevTools Protocol.

What do I need to set up before troubleshooting ArkWeb DevTools connections?▼

Before troubleshooting ArkWeb DevTools connections, you need a HarmonyOS project folder with a valid package name, a connected device for HDC port forwarding, and the bundled start-debug scripts to initiate the webview inspection session.