uni-app无法直接调用iOS原生锁屏API，因Apple严格限制；必须通过条件编译+自研原生插件实现，且需满足VC实例绑定、主线程执行、用户显式触发等硬性要求。
uni-app 无法直接调用 iOS 原生锁屏控制 API（如 UIDevice.current.setValue 或 UIApplication.shared.statusBarOrientation），因为 Apple 严格限制第三方应用强制锁定/旋转屏幕——该能力仅限系统级应用或特定场景（如视频播放、游戏）且需用户主动触发，uni-app 的 JS 层无权限绕过。
iOS 屏幕方向锁定必须走原生插件，uni.setScreenOrientation 在 App 端无效
直接写 uni.setScreenOrientation('landscape') 在 iOS 打包后会静默失败，控制台无报错，返回值为 undefined 或直接忽略。这不是 bug，而是 DCloud 官方明确禁用该 API 在 App 端的实现（因 iOS 不允许 JS 层干预系统级方向控制）。唯一可行路径是：条件编译 + 自研原生插件。
- 必须用
uni.requireNativePlugin('ScreenOrientation')加载插件，不能 import 或 require - 插件名
ScreenOrientation必须与nativeplugins/ScreenOrientation/目录名、package.json中"name"字段完全一致（大小写敏感） - iOS 插件的 Objective-C 类名（如
DSScreenOrientationPlugin）必须在package.json的_dp_nativeplugin.ios.class中精确声明，不能是 Swift 类名或模块名 - 插件
main:方法签名必须为- (void)main:(NSDictionary *)options success:(JSCallback)success fail:(JSCallback)fail，漏掉fail参数会导致 JS 调用后无响应
原生插件里调用 iOS 锁屏 API 的关键限制
iOS 没有“全局锁屏”接口，只能通过 UIViewController 控制当前页面方向，且需满足两个硬性前提：当前 ViewController 是 window 的 rootViewController，且未被导航栈遮挡。否则调用 shouldAutorotate 或 supportedInterfaceOrientations 无效。
- 必须在主线程执行 UI 变更：
dispatch_async(dispatch_get_main_queue(), ^{ ... }) - 不能直接修改
UIDevice.current.orientation——这是只读属性，改了也没用 - 真正生效的是重写当前 VC 的
supportedInterfaceOrientations并触发attemptRotationToDeviceOrientation - 若页面嵌套在
UINavigationController下，需对 navigation controller 本身重写方向方法，而非其子 VC - 调用后必须等系统回调完成再通知 JS，不能立即
success，否则方向未真正切换就返回
用户触发时机必须明确，不能自动锁屏
iOS 审核严格禁止 App 启动或后台时自动锁定方向。锁屏操作必须由用户显式动作触发（如点击「横屏模式」按钮），且需在 UI 上同步提示当前状态。
- 按钮文案必须实时反映状态，例如显示「已锁定横屏」而非静态「锁定」
- 监听
onShow时需重新检查当前方向：[[UIDevice currentDevice] orientation]不可靠，应读取[[UIApplication sharedApplication] statusBarOrientation] - 用户从设置页返回后，需延时 100ms 再读取方向值，避免系统尚未完成旋转动画
- 若用户手动旋转设备，插件需监听
UIDeviceOrientationDidChangeNotification并同步更新 JS 层状态，否则 UI 与实际不符
最易被忽略的点是：iOS 插件里所有方向变更必须绑定到当前活跃的 UIViewController 实例，而 uni-app 的页面生命周期和原生 VC 实例映射关系不稳定——一个 Vue 页面可能对应多个 VC 实例（尤其涉及 tabbar 切换时），不加实例缓存或弱引用管理，很容易调错对象导致锁屏失效。
