hmos-ui-verify

Validates HarmonyOS app UI and interactions on devices using dcli UI automation tools.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/YrracOwl/dsh-hmos-sidebar --skill hmos-ui-verify-yrracowl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hmos-ui-verify
Source: https://github.com/YrracOwl/dsh-hmos-sidebar/tree/main/packages/dsh-hmos-sidebar/presets/native-harmonyos/skills/hmos-ui-verify
Command: npx skills add https://github.com/YrracOwl/dsh-hmos-sidebar --skill hmos-ui-verify-yrracowl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After implementing a HarmonyOS feature, static checks alone cannot confirm the app actually behaves correctly on a real device. This Skill closes the acceptance loop by driving the app on a physical device or emulator, operating its UI, and visually verifying each screen against requirements. ## Core Features & Use Cases - End-to-end device workflow: Confirms devices are online, builds and installs the debug-signed HAP, and launches the app via dcli tools. - UI inspection and operation: Reads the on-screen node tree with dcli__ui_layout, then clicks, swipes, and inputs text through dcli__ui_click, dcli__ui_swipe, and dcli__ui_text. - Screenshot-based verification: Captures per-step screenshots with dcli__ui_screenshot and inspects them with read_image to compare against expected results, falling back to device logs for failures. - Use Case: After finishing a login page, build and install the app on an emulator, tap the login button, screenshot the result, and confirm the home page displays the user nickname. ## Quick Start Verify the login flow of my HarmonyOS app on a connected device by building, installing, tapping through the screens, and checking screenshots against the expected behavior.

Frequently Asked Questions about hmos-ui-verify

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

FAQPage Schema
How do I verify HarmonyOS app UI on a real device?

Build a debug-signed package with dcli__build_project, install it via dcli__install_hap, launch with dcli__start_app, then inspect the node tree with dcli__ui_layout and operate the UI using dcli__ui_click, ui_swipe, and ui_text while checking screenshots.

How to automate UI testing on HarmonyOS without a test framework?

Use the dcli UI tools directly: query the screen node tree with dcli__ui_layout in JSON format, perform clicks and swipes by id or coordinates, capture screenshots with dcli__ui_screenshot, and visually confirm each step with read_image.

Can I run HarmonyOS UI verification without a physical device?

Yes. If no device is online, list available emulators with dcli__list_emulators and start one with dcli__emulator_start, then run the same build, install, and UI verification flow on the emulator.

Why does dcli__ui_layout return no nodes?

This usually means the target app is not in the foreground or the UI test service is unavailable on the device or emulator. Confirm the app is launched and focused, and try adjusting the layout mode or depth parameters.

What should I do when a UI verification step fails?

Capture a screenshot and compare it carefully against expectations, watching for status bars, dialogs, and animation timing. Then pull device logs with dcli__get_device_logs to find crash stacks or errors, fix the issue, and re-run the verification.