hmos-multidevice-screen-window-window-size

Classify and fix HarmonyOS layout problems from screen and window size changes.

31|6|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/openharmonyinsight/openharmony-skills --skill hmos-multidevice-screen-window-window-size
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hmos-multidevice-screen-window-window-size
Source: https://github.com/openharmonyinsight/openharmony-skills/tree/main/skills/harmonyos-ai-agent-skill/references/hmos-multidevice-screen-window-size
Command: npx skills add https://github.com/openharmonyinsight/openharmony-skills --skill hmos-multidevice-screen-window-window-size

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you handle HarmonyOS UI layout failures caused by multi-device screen/window size changes, including breakpoint mismatch, incorrect responsive container choices, stale window-size state, and missing font/density synchronization.

Core Features & Use Cases

  • Breakpoint-driven responsive routing (REQ/DEV/FIX/VAL): Classifies whether you are designing, implementing, fixing, or validating a screen-window adaptation problem and routes to the correct sub-scenario.
  • Window-size and breakpoint synchronization: Ensures runtime window size observation updates breakpoint state and drives immediate layout refresh without breaking single-screen baseline.
  • Responsive container and rule-based fixes: Guides choosing GridRow/GridCol and related containers for structure switching, and includes guardrails for common anomaly types like truncation, offset, overlap, and font/density issues.
  • Multi-screen validation evidence matrix: Produces an objective verification matrix with required evidence (screenshots/layout dumps/window size proofs) and regression watchlist.

Quick Start

Ask the AI to analyze my HarmonyOS multi-device layout issue (including device type and whether it happens in REQ/DEV/FIX/VAL), identify the most likely size anomaly category and root cause, then output a step-by-step fix plan and a validation evidence matrix.

Frequently Asked Questions about hmos-multidevice-screen-window-window-size

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

FAQPage Schema
How do I fix responsive layout issues in HarmonyOS when window size changes across devices?

To fix responsive layout issues in HarmonyOS, classify the screen anomaly by breakpoint mismatch or stale state, then apply GridRow/GridCol containers for structure switching and explicit window-change listeners with lifecycle cancellation.

Why does my HarmonyOS breakpoint system fail to trigger layout refresh during split-screen or in-window mode?

Your breakpoint system fails during split-screen because runtime window size observation lacks explicit window-change listener logic with lifecycle cancellation, causing stale breakpoint state that prevents immediate layout refresh without breaking single-screen baseline.

What's the best way to handle font scale and display density adaptation across HarmonyOS phone, tablet, and TV devices?

The best way to handle font scale and display density adaptation is using a consistent breakpoint strategy alongside responsive containers like GridRow/GridCol, ensuring runtime window size synchronization updates breakpoint state and drives immediate layout refresh.

How do I validate multi-device UI adaptation for HarmonyOS without missing regression on truncation or overlap anomalies?

To validate multi-device UI adaptation, produce an objective verification matrix with required evidence including screenshots, layout dumps, and window size proofs, alongside a regression watchlist targeting truncation, offset, and overlap anomalies.

Does HarmonyOS require GridRow/GridCol for responsive container structure switching on 2-in-1 devices?

HarmonyOS prefers GridRow/GridCol for responsive container structure switching on 2-in-1 devices, applying rule-based fixes with guardrails for common anomalies like truncation, offset, and overlap while maintaining a consistent breakpoint strategy.

What limitations exist when using a breakpoint system for multi-device screen adaptation in HarmonyOS split mode?

Breakpoint system limitations in HarmonyOS split mode include stale window-size state if listener lifecycle cancellation is missing, requiring explicit window-change listener logic to synchronize breakpoint state and drive immediate layout refresh without breaking single-screen baseline.