hmos-multidevice-natural-orientation

What problem does it solve?

It solves inconsistent orientation behavior on HarmonyOS multi-device scenarios by correctly separating screen rotation, display orientation, window orientation, and natural orientation, then applying the right rotation strategy with lifecycle-safe updates.

Core Features & Use Cases

• Natural orientation & rotation semantics: Establishes the correct mapping between natural portrait/landscape states and the meaning of rotation values, including special handling for tri-fold G-state.
• Window-safe orientation control: Applies rotation changes only via the main window using setPreferredOrientation(), with clear boundaries for where it must not be used.
• Multi-device adaptation & bug repair: Provides scene-based guidance for multi-form-factor adaptations and for common direction bugs (Tabs/Swiper lock issues, foldable forced portrait, split/suspended window failures, video full-screen restore issues).

Use Case: Your app’s video page and short-video feed intermittently end up in the wrong portrait/landscape mode on tablets and foldables; you need a unified strategy that handles rotation semantics and restores orientation correctly after page transitions and full-screen exit.

Quick Start

Use hmos-multidevice-natural-orientation to produce a REQ/DEV/FIX/VAL plan for your target page, ensuring correct natural orientation mapping, setPreferredOrientation usage boundaries, and a device coverage verification matrix.