使用cordova-plugin-screen-orientation锁定横竖屏失效问题排查

• 确认插件安装状态
  先执行cordova plugin list，检查输出中是否包含cordova-plugin-screen-orientation。如果没有，重新安装插件：cordova plugin add cordova-plugin-screen-orientation，安装完成后必须重新构建项目（cordova build android）再运行测试。

• 确保代码在deviceready事件后执行
  Cordova所有插件API都要等deviceready事件触发后才能正常调用，这是最容易忽略的点。如果你的锁定逻辑没放在这个回调里，插件还未初始化，自然不会生效。正确写法示例：

  document.addEventListener("deviceready", onDeviceReady, false);
  function onDeviceReady() {
      // 设备类型判断与方向锁定逻辑
      const smallestSide = Math.min(window.innerWidth, window.innerHeight);
      const isTablet = smallestSide >= 600;
      if (isTablet) {
          screen.orientation.lock('landscape-primary');
      } else {
          screen.orientation.lock('portrait-primary');
      }
  }
  

• 检查AndroidManifest.xml的配置冲突
  即便你没在config.xml中配置orientation，Cordova默认会在platforms/android/app/src/main/AndroidManifest.xml的activity标签里生成android:screenOrientation属性。如果这个属性是固定值（比如portrait），会直接覆盖插件的动态设置。解决方法：

  1. 手动删除AndroidManifest里的android:screenOrientation属性；
  2. 在config.xml中添加<preference name="orientation" value="default" />，让Cordova生成默认配置，允许插件动态控制方向。

• 验证锁定方向的参数正确性
  插件支持的合法参数为：portrait、portrait-primary、portrait-secondary、landscape、landscape-primary、landscape-secondary、default。如果参数拼写错误（比如把landscape写成horizontal），会直接失效。部分设备对通用方向参数支持不佳，可以尝试指定主方向（比如landscape-primary替代landscape）。

• 修正设备类型判断逻辑
  你的尺寸判断可能存在误差，比如Pixel手机横屏时宽度可能超过平板阈值，导致判断逻辑反转。建议取屏幕的最小边作为判断依据（避免横竖屏切换影响判断），示例：

  const smallestSide = Math.min(window.innerWidth, window.innerHeight);
  const isTablet = smallestSide >= 600; // 通用平板阈值
  

• 检查系统自动旋转设置
  测试设备（模拟器和Pixel手机）必须开启自动旋转屏幕功能。如果系统关闭了自动旋转，插件的方向锁定指令会被系统限制，无法生效。

• 排查版本兼容性问题
  旧版本的cordova-plugin-screen-orientation可能与最新的Cordova Android版本（如12+）不兼容。尝试更新插件：cordova plugin update cordova-plugin-screen-orientation，确保插件版本与当前Cordova环境匹配。

内容的提问来源于stack exchange，提问作者Michael Barsotti