PhoneGap屏幕方向锁定失效：Android端无法固定竖屏求助

我之前也踩过PhoneGap Android屏幕锁定的坑，太懂这种配置了却不生效的烦躁！给你几个实测有效的解决思路：

1. 先确认config.xml的配置是否精准 #

很多时候是配置参数没写对，竖屏锁定的正确配置应该是：

<preference name="orientation" value="portrait" />

如果要锁定仅正竖屏（禁止倒转），可以更明确地写：

<preference name="orientation" value="portrait-primary" />

另外，部分Android版本需要在生成的AndroidManifest.xml里补充配置（本地构建时可以手动修改，在线构建的话会自动同步config.xml，但偶尔会出问题）：
在主Activity标签里添加屏幕方向属性：

<activity android:name="MainActivity" android:screenOrientation="portrait">

2. 用Cordova官方的屏幕方向插件（比原生配置更可靠） #

原生配置有时候会被系统或构建工具忽略，用官方插件几乎能解决90%的问题：

• 先安装插件：

  cordova plugin add cordova-plugin-screen-orientation
  

• 然后在onDeviceReady函数里添加锁定代码，一定要等设备就绪后再执行：

  document.addEventListener("deviceready", onDeviceReady, false);
  function onDeviceReady() {
      // 锁定为竖屏（支持portrait/portrait-primary/portrait-secondary等值）
      screen.lockOrientation('portrait-primary');
      
      // 可以加个监听，看看方向变化的日志，方便排查问题
      screen.addEventListener('orientationchange', () => {
          console.log('当前屏幕方向:', screen.orientation.type);
      });
  }
  

3. 排查系统设置和权限干扰 #

• 有些Android设备的全局「自动旋转」开关或者「智能旋转」功能，可能会对APP的锁定设置产生影响，可以先让测试设备关闭这些功能再试；
• 确认APP是否有必要的权限，不过方向锁定一般不需要额外权限，旧版本PhoneGap可以在config.xml里补充：

  <uses-permission android:name="android.permission.WRITE_SETTINGS" />
  

4. 检查构建工具的缓存和版本 #

如果你用的是在线构建工具（比如PhoneGap Build），缓存是常见的坑——有时候修改了config.xml但构建工具还在使用旧缓存，建议清理构建缓存后重新上传代码；另外，尽量使用较新的Cordova稳定版本，旧版本可能存在屏幕方向的兼容bug。

如果以上方法都试过还是不行，可以把你的config.xml相关配置和onDeviceReady代码贴出来，能更精准定位问题！

内容的提问来源于stack exchange，提问作者Sandu Adrian