App端强制横屏必须修改原生配置：iOS需在manifest.json的app-plus.distribute.ios.orientation设为["landscape-primary","landscape-secondary"]，Android需在app-plus.distribute.android.orientation设为"landscape"，二者缺一不可且须云打包生效；pages.json的pageOrientation和uni.setScreenOrientation在App端均无效。
App端无法靠JS或CSS实现真正的强制横屏——必须改原生配置，否则触摸错位、Canvas拉伸、键盘异常等问题必然出现。
manifest.json 的 orientation 配置必须分平台写对
iOS 和 Android 的配置项互不兼容，填错一个字符就白配：
- iOS 必须在
manifest.json的app-plus.distribute.ios.orientation下填数组：["landscape-primary", "landscape-secondary"]；填"landscape"或单个字符串会被完全忽略 - Android 对应位置是
app-plus.distribute.android.orientation，只接受字符串："landscape"（不区分主次，系统自动适配） - 这两个字段必须同时存在且值合法，缺一不可；只配 iOS 不配 Android，Android 端照样竖屏
- 改完不重新云打包或制作自定义基座，真机上 100% 无效——“运行到手机”调试器里的热重载不触发原生层更新
pages.json 的 pageOrientation 在 App 端完全无效
你在 pages.json 里给某个页面加了 pageOrientation: "landscape"，App 打包后不会有任何反应：
- 该字段仅对微信小程序、支付宝小程序、H5 生效；App 端编译时直接跳过
- 常见错误是把小程序配置复制进 App 工程，比如：
{"path":"pages/game/game","style":{"pageOrientation":"landscape"}}，这行代码在 App 真机上等于注释 - 若只想某页面横屏（如游戏页），唯一可靠方式是让它对应一个独立的、已在原生层声明为
landscape的 Activity（Android）或 ViewController（iOS）
uni.setScreenOrientation 在 App 真机上基本不可信
这个 API 在 App 端不是“有时失效”，而是有明确平台边界：
- iOS 真机调用后返回
{ result: 'fail', errMsg: 'not supported' }，既不报错也不生效 - Android 仅在 targetSdkVersion android:screenOrientation 的旧机型上可能成功；Android 12+ 大部分被系统拦截
- 必须在
onShow中调用（非onLoad），因用户切后台再回来时方向可能已变 - 返回是 Promise，但失败时 resolve 而非 reject，务必检查
res.result === 'fail'，否则你以为锁住了，其实没动
横屏 UI 交互适配的关键陷阱
即使原生配置全对，UI 层仍容易出问题：
- 别用
transform: rotate(90deg)模拟横屏——Canvas 尺寸错乱、触摸坐标偏移、键盘弹不出，游戏类场景绝对禁用 -
uni.getSystemInfo返回的是设备物理方向下的宽高，横屏时screenWidth反而比screenHeight小；正确做法是监听plus.screen.onorientationchange后再读取实时视口尺寸 - 视频全屏退出后，页面常卡在横屏状态；需监听
plus.video.Player.onstatechanged，当state === 4（ended）时手动调用plus.screen.lockOrientation('portrait-primary') - iOS 上无法运行时动态切回竖屏，所以“首页横屏 + 其他页竖屏”的需求，必须拆成不同原生页面或用 subNVue 实现
真正卡住人的从来不是怎么写代码，而是哪一层该管什么、哪一层根本管不了——原生配置漏一项，后面所有 JS 都是徒劳；UI 层没监听 orientationchange，getSystemInfo 拿到的就是错的尺寸。这些点不提前踩一遍，上线后只能靠用户旋转手机来“修复”。
