cordova-ios v6中deviceorientation监听代码失效原因咨询

核心原因 #

Cordova iOS v6 最大的变更是将默认WebView从UIWebView替换为WKWebView，而WKWebView对设备传感器权限的管控比UIWebView严格得多，同时iOS 13+（Cordova iOS v6最低支持iOS 11，但实际适配中iOS 13+的权限规则影响更大）对设备方向/运动数据的访问增加了强制授权要求，这直接导致你的代码出现以下问题：

• deviceorientationabsolute 无法被检测到：WKWebView中该事件的暴露需要满足更严格的权限条件，未授权时window对象不会包含该属性，因此代码直接进入deviceorientation分支。
• deviceorientation 事件无回调：即使代码监听了该事件，若未获取用户的运动权限授权，iOS会直接阻止事件触发，仅能打印日志但不会执行回调逻辑。

具体解决步骤 #

1. 添加Info.plist权限描述 #

在项目的Info.plist中添加NSMotionUsageDescription键，说明应用请求运动权限的用途（iOS要求必须填写，否则会导致权限请求失败）：

<key>NSMotionUsageDescription</key>
<string>需要访问设备方向数据以提供对应功能</string>

替换<string>中的内容为你的实际业务场景描述。

2. 安装适配WKWebView的官方插件 #

Cordova官方的cordova-plugin-device-motion插件已适配WKWebView，确保安装最新版本：

cordova plugin remove cordova-plugin-device-motion
cordova plugin add cordova-plugin-device-motion

该插件会自动处理权限请求和事件适配，比直接监听原生DOM事件更可靠。

3. 手动触发权限请求（无插件场景） #

如果坚持使用原生DOM事件监听，需先请求用户授权，再执行监听逻辑：

// 请求运动权限
if (typeof DeviceMotionEvent.requestPermission === 'function') {
    DeviceMotionEvent.requestPermission()
        .then(permissionState => {
            if (permissionState === 'granted') {
                // 权限已授权，启动方向监听
                watchOrientation(yourCallback);
            }
        })
        .catch(console.error);
}

4. 验证配置 #

1. 重新编译iOS项目：cordova build ios
2. 在iOS设备上运行应用，首次启动时选择"允许"权限请求
3. 测试设备方向变化，检查回调是否正常执行

内容的提问来源于stack exchange，提问作者Jordan Azoulay