OpenHarmony 4.0 Release横屏配置

关注

原创 2025-10-10 16:51:51 1.1k 阅读 AI 写同款· GEO 优化 ›

OpenHarmony如何切换横竖屏？在日常开发中，大多APP可能根据实际情况直接将APP的界面方向固定，或竖屏或横屏。但在使用过程中，我们还是会遇到横竖屏切换的功能需求，可能是通过物理重力感应触发，也有可能是用户手动触发。所以本文主要带大家了解在OpenAtom OpenHarmony（以下简称“OpenHarmony”）应用开发的过程中，如何在Stage模型和FA模型下使用对应的接口去完成横竖屏的切换。本文中OpenHarmony版本为3.2 Beta4，API版本为9。开发板为DAYU200。阅读详情

一、前言

OpenHarmony源码默认基于手机类竖屏设备配置，在某些行业或场景，如平板、电视、广告机等常常需要横屏显示，因此需要修改OpenHarmony 默认显示方向，由竖屏改为横屏。

二、环境配置

系统版本： OpenHarmony 4.0 Release (4.0.10.13) 32bit
设备平台：DAYU 200 RK3568

三、系统默认横屏

3.1屏幕方向调试命令

可使用hdc命令修改设备/system/etc/window/resources/display_manager_config.xml配置文件buildInDefaultOrientation参数，重启生效：

# 拷贝设备display_manager_config.xml 至本地桌面
hdc shell mount -o remount,rw /;hdc file recv /system/etc/window/resources/display_manager_config.xml  C:\Users\xxx\Desktop\display_manager_config.xml

# 修改buildInDefaultOrientation并保存(默认为0)
<buildInDefaultOrientation>2</buildInDefaultOrientation>

# 拷贝本地display_manager_config.xml 至设备原路径
hdc shell mount -o remount,rw /;hdc file send C:\Users\xxx\Desktop\display_manager_config.xml /system/etc/window/resources/display_manager_config.xml

#重启生效
hdc shell reboot

3.2不同配置值效果

未指定: <buildInDefaultOrientation>0<buildInDefaultOrientation> 表示未指定屏幕方向，使用默认方向，与<buildInDefaultOrientation>1<buildInDefaultOrientation>显示一致
竖屏: <buildInDefaultOrientation>1<buildInDefaultOrientation>
横屏: <buildInDefaultOrientation>2<buildInDefaultOrientation>
竖屏反转: <buildInDefaultOrientation>3<buildInDefaultOrientation>
横屏反转: <buildInDefaultOrientation>4<buildInDefaultOrientation>

3.3 源码修改

rk3568设备/system/etc/window/resources/display_manager_config.xml配置文件在源码中对应
foundation/window/window_manager/resources/config/rk3568/display_manager_config.xml

    <!-- Indicates orientation of the built-in screen -->
    <!-- 0: Orientation::UNSPECIFIED -->
    <!-- 1: Orientation::VERTICAL         2: Orientation::HORIZONTAL-->
    <!-- 3: Orientation::REVERSE_VERTICAL 4: Orientation::REVERSE_HORIZONTAL -->
    <buildInDefaultOrientation>2</buildInDefaultOrientation>

全编后更新系统验证。

细心的你可能发现，Launcher概率性竖屏，并显示异常，但系统设置应用横屏正常。

3.4 横屏异常处理

系统由横屏改为竖屏后，仍有一些未完全适配的问题，如：开机Logo&开机视频仍竖屏、Launcher概率性竖屏异常，输入法UI横屏适配异常、OTA升级UI竖屏显示等。

开机画未横屏显示：使用横屏开机画替换原本的竖屏开机画
原开机第一画：device\board\hihope\rk3568\kernel\logo.bmp

原开机第二画：device\board\hihope\rk3568\kernel\logo_kernel.bmp
开机动画和Launcher概率性横屏显示竖屏：已有先关文章，此处笔者不再赘述，可参考：OpenHarmony系统解决方案 - 配置屏幕方向导致开机动画和Launcher显示异常

✍OneMoreThink
修改foundation/window/window_manager/wmserver/src/window_node_container.cpp可模块化编译和验证：
注意：64位系统, libwms.z.so拷贝至/system/lib64/libwms.z.so

#模块化编译libwms.z.so
./build.sh -p rk3568 --build-target libwms

#将生成的libwms.z.so替换设备libwms.z.so
hdc shell mount -o remount,rw /;hdc file send xxx\out\rk3568\window\window_manager\libwms.z.so /system/lib/libwms.z.so
# 重启设备生效
hdc shell reboot

更多OpenHarmony模块编译技巧可参考OpenHarmony模块化编译↩

recovery升级界面未横屏显示：将在后续文章中分享，请关注更新~

四、应用设置屏幕方向

本章节介绍在应用中如何设置屏幕方向

设置应用UI方向
可在module.json5 abilities配置中添加orientation：

"abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        ...
        "orientation": "auto_rotation",
        "startWindowIcon": "$media:startIcon",
        "startWindowBackground": "$color:start_window_background",
        ...
      }
    ]

参考：module.json5配置文件-abilities标签↩
orientation 标识当前UIAbility组件启动时的方向，支持配置枚举，或启动方向资源索引。
启动方向枚举支持的取值如下：

- unspecified：未指定方向，由系统自动判断显示方向。
- landscape：横屏。
- portrait：竖屏。
- follow_recent：跟随背景窗口的旋转模式。
- landscape_inverted：反向横屏。
- portrait_inverted：反向竖屏。
- auto_rotation：随传感器旋转。
- auto_rotation_landscape：传感器横屏旋转，包括横屏和反向横屏。
- auto_rotation_portrait：传感器竖屏旋转，包括竖屏和反向竖屏。
- auto_rotation_restricted：传感器开关打开，方向可随传感器旋转。
- auto_rotation_landscape_restricted：传感器开关打开，方向可随传感器旋转为横屏， 包括横屏和反向横屏。
- auto_rotation_portrait_restricted：传感器开关打开，方向随可传感器旋转为竖屏， 包括竖屏和反向竖屏。
- locked：传感器开关关闭，方向锁定。
- auto_rotation_unspecified：受开关控制和由系统判定的自动旋转模式。
- follow_desktop：跟随桌面的旋转模式。
 配置启动方向的资源索引时，取值为长度不超过255字节的字符串，配置示例：$string:orientation。
 说明：
 - 从API version 14开始，支持配置启动方向资源索引。	字符串	该标签可缺省，缺省值为unspecified。

设置系统屏幕方向
使用@ohos.screen setOrientation()接口即可

let promise: Promise<Array<screen.Screen>> = screen.getAllScreens();
  promise.then((data: Array<screen.Screen>) => {
    this.mScreen = data[0];
    this.mScreenRotation = this.mScreen.orientation
    console.log('Succeeded in getting all screens. Data:' + JSON.stringify(data));
  }).catch((err: BusinessError) => {
    console.log('Failed to get all screens. Cause: ' + JSON.stringify(err));
  });

this.mScreen.setOrientation(this.mScreenRotation, (err: BusinessError) => {
   const errCode: number = err.code;
   if (errCode) {
     console.error('Failed to set the vertical orientation. Code: ' + JSON.stringify(err));
     return;
   }
   console.info('Succeeded in setting the vertical orientation.');
 });

请添加图片描述
Demo参考：ScreenDemo