折叠屏设备在屏幕比例、可视区域、交互方式和设备形态上，与直板机存在明显差异。
如果您的应用包含登录、搜索、编辑、拍摄等核心链路，建议重点关注分屏、折叠态/ 展开态、内外屏切换、软键盘弹出、调用摄像头等场景下的显示与交互表现。
为帮助开发者更高效完成折叠屏等多形态设备适配，建议按下述顺序推进：
1. 先使用直板机分屏能力完成一轮低成本适配自检；
2. 再通过远程真机或模拟器验证折叠态、展开态、内外屏切换等关键形态；
l 模拟器使用指引：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-create
一、TOP 3 常见场景
1. 小窗口 / 阔折叠内屏下，控件被截断，关键操作不可见或不可点击
以阔折叠内屏场景为例，部分页面在显示区域缩小时，可能出现内容截断、底部按钮不可见、弹窗显示不全等问题，可能影响功能操作体验。
可能原因
l 页面仅按全屏尺寸进行适配，未充分考虑窗口缩小后的布局变化
l 内容区未采用可滚动容器，窗口缩小时无法继续浏览
l 关键按钮、确认区、关闭区被固定在不可见区域
l 弹层、自定义面板未设置合理的尺寸约束，在受限窗口中超出可显示区域
最小适配建议
1. 内容区优先使用可滚动容器或列表类组件，例如 Scroll、List、WaterFlow，让原先不可见的内容可以通过滑动查看；
2. 优先压缩非核心展示区域，保证提交、确认、关闭、下一步等关键操作始终处于可见可点区域；
3. 避免在受限窗口中依赖固定高度、固定宽度布局，优先使用可伸缩、自适应布局；
4. 对弹层、抽屉、半屏页增加尺寸约束，必要时在弹层内部增加滚动能力；
建议优先检查的页面
l 页面存在固定高度布局的组件
l 应用开屏页或隐私协议与授权确认页面
【查看解决方案】：
l Scroll 容器组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-scroll
l List 列表组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list
l WaterFlow 容器组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-waterflow
2. 软键盘弹出后，输入框或发送 / 确认按钮被遮挡
在阔折叠设备上编辑、评论等输入场景中，软键盘弹出后，输入框、底部操作区、发送按钮或确认按钮被遮挡。
可能原因
l 系统默认避让策略只能优先保证当前输入框不被遮挡，无法自动保证底部操作区始终可见
l 页面内容区没有根据可视区域变化动态收缩
l 页面中存在大量固定高度组件，导致压缩后布局无法自然调整
l 页面缺少软键盘高度监听和可视区域变化处理
最小适配建议
1. 对输入、表单、编辑类页面，可优先评估使用压缩避让模式，并结合页面可伸缩布局及可视区域变化处理。
2. 页面内容区尽量采用可伸缩或自适应高度布局，避免关键区域使用固定高度。
建议优先排查的页面
l 搜索页
l 登录页/ 注册页
l 发布页/ 表单填写页
【查看解决方案】
l 软键盘布局适配：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-keyboard-layout-adapt
3. 调用相机时，画面方向错误或预览异常
在折叠屏展开、旋转设备、内外屏切换或切换特殊形态后，相机预览可能出现比例异常、画面颠倒、方向错误等问题。
可能原因
l 折叠状态切换后，仍继续使用切换前的相机设备或预览流
l 仅按“前置 / 后置”固定逻辑选相机，未基于当前形态重新判断可用相机列表
l 预览区域尺寸变化后，预览比例和方向未重新校正
l 页面切换后未对当前相机、方向、预览流进行重建和兜底回退
最小整改建议
1. 在折叠状态、窗口尺寸或设备方向变化后，重新判断当前形态下可用的相机设备；
2. 相机选择不要只按固定“前置 / 后置”逻辑处理，应结合当前设备形态和可用相机列表重新判断；
3. 当切换后原相机不可用时，应自动回退到当前形态下默认可用相机；
4. 重新拉起预览流时，同时校验页面方向、预览比例和预览区域尺寸；
5. 对扫码、拍照、录制、视频通话等相机场景分别验证。
【查看解决方案】
l 相机旋转角度：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/camera-rotation-term
l 适配相机旋转角度：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/camera-rotation-angle-adaptation
二、开发者自检走查清单
开发者可以借助直板机应用分屏功能，先检查不同窗口大小下的适配效果；
也可以通过远程真机或真机，查看 Pura X、Mate X 系列、Mate XT 等折叠屏设备上的实际显示效果。
最小走查清单（建议必查）
1. 首页/ 主页面：检查显示完整性、布局稳定性、功能入口和按钮可达性。
2. 核心链路：检查登录、搜索、支付、发布、播放等关键流程是否存在遮挡、错位或中断。
3. 形态切换：检查折叠态/ 展开态、内外屏切换后，页面是否正常重排，状态是否连续保留。
4. 多窗口/ 分屏：检查缩放、分栏及恢复全屏后，内容和关键操作是否仍可见可点。
5. 横竖屏/ 全屏：检查沉浸场景在方向切换和全屏切换后的布局与恢复状态。
6. 键盘/ 弹窗 / 浮层：检查键盘遮挡、弹窗可操作性以及浮层位置是否正常。
更多开发资料，请戳官方链接👇
附：官方文档资源
l 折叠屏应用开发：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-foldable-guide
l Pura X 阔折叠应用开发：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-purax-guide
l 三折叠应用开发：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-matext-guide
l 多设备界面设计：https://developer.huawei.com/consumer/cn/doc/design-guides/design-principles-0000001957023989
l 多设备开发最佳实践：https://developer.huawei.com/consumer/cn/best-practices/multidevice/
l 多窗口适配：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-multi-device-window-mode
l 软键盘避让：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-keyboard-layout-adapt
l 相机适配与旋转角度适配：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/camera-rotation-angle-adaptation
