React Native Android端Dimensions.addEventListener未触发问题求助

排查与修复步骤 #

1. 检查AndroidManifest.xml的屏幕方向配置 #

打开android/app/src/main/AndroidManifest.xml，找到对应的<activity>标签，确保android:screenOrientation属性设置为支持旋转的值：

• 推荐设为"sensor"（支持横竖屏旋转，依赖设备传感器）或"fullSensor"（支持所有方向，包括反向横竖屏）
• 避免设置为固定方向如"portrait"或"landscape"，否则旋转不会触发尺寸变化事件

示例配置：

<activity
  android:name=".MainActivity"
  android:screenOrientation="sensor"
  ...>

2. 改用useWindowDimensions钩子替代Dimensions事件监听 #

React Native提供的useWindowDimensions钩子会自动监听窗口尺寸变化，相比手动绑定Dimensions事件更可靠，尤其在Android端。修改代码如下：

import { useWindowDimensions } from 'react-native';

// 在组件内部
const { width, height } = useWindowDimensions();

useEffect(() => {
  const isLandscape = width > height;
  setOrientation(isLandscape ? 'LANDSCAPE' : 'PORTRAIT');
  console.log("what is orientation: " + isLandscape);
}, [width, height]);

3. 排查代码中是否强制锁定了屏幕方向 #

检查项目中是否使用了第三方库（如react-native-orientation-locker）或原生代码锁定了屏幕方向。如果有，确保在需要检测旋转的场景下解锁方向，或者调整锁定逻辑。

4. 验证设备系统级自动旋转设置 #

再次确认：

• 设备的自动旋转功能已开启（下拉状态栏查看"自动旋转"开关）
• 应用未被排除在系统自动旋转列表之外（部分设备支持单独设置应用的旋转权限）

5. 检查RN版本兼容性问题 #

React Native 0.67.x在Android端的Dimensions事件存在偶发的触发延迟或失效问题，升级到较新版本（如0.68+）可能解决该问题，但如果无法升级，优先使用useWindowDimensions方案。

内容的提问来源于stack exchange，提问作者Faisal Shaikh