折叠屏设备在屏幕比例、可视区域、交互方式和设备形态上，与直板机存在明显差异。

如果您的应用包含登录、搜索、编辑、拍摄等核心链路，建议重点关注分屏、折叠态 / 展开态、内外屏切换、软键盘弹出、调用摄像头等场景下的显示与交互表现。

为帮助开发者更高效完成折叠屏等多形态设备适配，建议按下述顺序推进：

1.      先使用直板机分屏能力完成一轮低成本适配自检；

2.      再通过远程真机或模拟器验证折叠态、展开态、内外屏切换等关键形态；

• 远程真机调试：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/redirectToService?menuId=9249519184596051206&type=project?ha_source=zxqy-IT&ha_sourceId=89000468
• 模拟器使用指引：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-create?ha_source=zxqy-IT&ha_sourceId=89000468

一、TOP 3常见场景

1. 小窗口 / 阔折叠内屏下，控件被截断，关键操作不可见或不可点击

以阔折叠内屏场景为例，部分页面在显示区域缩小时，可能出现内容截断、底部按钮不可见、弹窗显示不全等问题，可能影响功能操作体验。

可能原因

• 页面仅按全屏尺寸进行适配，未充分考虑窗口缩小后的布局变化
• 内容区未采用可滚动容器，窗口缩小时无法继续浏览
• 关键按钮、确认区、关闭区被固定在不可见区域
• 弹层、自定义面板未设置合理的尺寸约束，在受限窗口中超出可显示区域

最小适配建议

1.      内容区优先使用可滚动容器或列表类组件，例如 Scroll、List、WaterFlow，让原先不可见的内容可以通过滑动查看；

2.      优先压缩非核心展示区域，保证提交、确认、关闭、下一步等关键操作始终处于可见可点区域；

3.      避免在受限窗口中依赖固定高度、固定宽度布局，优先使用可伸缩、自适应布局；

4.      对弹层、抽屉、半屏页增加尺寸约束，必要时在弹层内部增加滚动能力；

建议优先检查的页面

• 页面存在固定高度布局的组件
• 应用开屏页或隐私协议与授权确认页面

【查看解决方案】：

• Scroll容器组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-scroll?ha_source=zxqy-IT&ha_sourceId=89000468
• List列表组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list?ha_source=zxqy-IT&ha_sourceId=89000468
• WaterFlow容器组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-waterflow?ha_source=zxqy-IT&ha_sourceId=89000468

2. 软键盘弹出后，输入框或发送 / 确认按钮被遮挡

在阔折叠设备上编辑、评论等输入场景中，软键盘弹出后，输入框、底部操作区、发送按钮或确认按钮被遮挡。

可能原因

• 系统默认避让策略只能优先保证当前输入框不被遮挡，无法自动保证底部操作区始终可见
• 页面内容区没有根据可视区域变化动态收缩
• 页面中存在大量固定高度组件，导致压缩后布局无法自然调整
• 页面缺少软键盘高度监听和可视区域变化处理

最小适配建议

1.      对输入、表单、编辑类页面，可优先评估使用压缩避让模式，并结合页面可伸缩布局及可视区域变化处理。

2.      页面内容区尽量采用可伸缩或自适应高度布局，避免关键区域使用固定高度。

建议优先排查的页面

• 搜索页
• 登录页 / 注册页
• 发布页 / 表单填写页

【查看解决方案】

• 软键盘布局适配：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-keyboard-layout-adapt?ha_source=zxqy-IT&ha_sourceId=89000468

3. 调用相机时，画面方向错误或预览异常

在折叠屏展开、旋转设备、内外屏切换或切换特殊形态后，相机预览可能出现比例异常、画面颠倒、方向错误等问题。

可能原因

• 折叠状态切换后，仍继续使用切换前的相机设备或预览流
• 仅按“前置 / 后置”固定逻辑选相机，未基于当前形态重新判断可用相机列表
• 预览区域尺寸变化后，预览比例和方向未重新校正
• 页面切换后未对当前相机、方向、预览流进行重建和兜底回退

最小整改建议

1.      在折叠状态、窗口尺寸或设备方向变化后，重新判断当前形态下可用的相机设备；

2.      相机选择不要只按固定“前置 / 后置”逻辑处理，应结合当前设备形态和可用相机列表重新判断；

3.      当切换后原相机不可用时，应自动回退到当前形态下默认可用相机；

4.      重新拉起预览流时，同时校验页面方向、预览比例和预览区域尺寸；

5.      对扫码、拍照、录制、视频通话等相机场景分别验证。

【查看解决方案】

l  相机旋转角度：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/camera-rotation-term?ha_source=zxqy-IT&ha_sourceId=89000468

l  适配相机旋转角度：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/camera-rotation-angle-adaptation?ha_source=zxqy-IT&ha_sourceId=89000468

l  相机硬件差异：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-multi-device-camera?utm_source=chatgpt.com?ha_source=zxqy-IT&ha_sourceId=89000468

二、开发者自检走查清单

开发者可以借助直板机应用分屏功能，先检查不同窗口大小下的适配效果；

也可以通过远程真机或真机，查看 Pura X、Mate X 系列、Mate XT 等折叠屏设备上的实际显示效果。

远程真机调试：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/redirectToService?menuId=9249519184596051206&type=project?ha_source=zxqy-IT&ha_sourceId=89000468

最小走查清单（建议必查）

1.      首页 / 主页面：检查显示完整性、布局稳定性、功能入口和按钮可达性。

2.      核心链路：检查登录、搜索、支付、发布、播放等关键流程是否存在遮挡、错位或中断。

3.      形态切换：检查折叠态 / 展开态、内外屏切换后，页面是否正常重排，状态是否连续保留。

4.      多窗口 / 分屏：检查缩放、分栏及恢复全屏后，内容和关键操作是否仍可见可点。

5.      横竖屏 / 全屏：检查沉浸场景在方向切换和全屏切换后的布局与恢复状态。

6.      键盘 / 弹窗 / 浮层：检查键盘遮挡、弹窗可操作性以及浮层位置是否正常。

附：官方文档资源

• 折叠屏应用开发：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-foldable-guide?ha_source=zxqy-IT&ha_sourceId=89000468
• Pura X阔折叠应用开发：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-purax-guide?ha_source=zxqy-IT&ha_sourceId=89000468
• 三折叠应用开发：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-matext-guide?ha_source=zxqy-IT&ha_sourceId=89000468
• 多设备界面设计：https://developer.huawei.com/consumer/cn/doc/design-guides/design-principles-0000001957023989?ha_source=zxqy-IT&ha_sourceId=89000468
• 多设备开发最佳实践：https://developer.huawei.com/consumer/cn/best-practices/multidevice/?ha_source=zxqy-IT&ha_sourceId=89000468
• 多窗口适配：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-multi-device-window-mode?ha_source=zxqy-IT&ha_sourceId=89000468
• 软键盘避让：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-keyboard-layout-adapt?ha_source=zxqy-IT&ha_sourceId=89000468
• 相机适配与旋转角度适配：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/camera-rotation-angle-adaptation?ha_source=zxqy-IT&ha_sourceId=89000468