新手求助：Expo Development Build无法运行问题

关键排查步骤 #

• 检查配置文件正确性
  1. 打开app.json或app.config.js，确认plugins数组里已经正确添加@config-plugins/react-native-ble-plx，示例配置：

     {
       "expo": {
         "plugins": ["@config-plugins/react-native-ble-plx"]
       }
     }
     

  2. 核对插件名称，别打错字
• 彻底清理缓存
  1. 终端执行npx expo start --clear清空Expo本地缓存
  2. 删掉手机上已经装的Development Build应用，重新扫码安装
• 校验版本一致性
  1. 确认package.json里的expo版本和Expo Go完全一致（都是51.x.x）
  2. 检查@config-plugins/react-native-ble-plx的版本是否适配Expo 51，可查看它的package.json里的peerDependencies要求
• 本地环境自检
  1. 确保Node.js版本是18.x或20.x（Expo 51推荐版本）
  2. 运行npx expo-doctor扫描环境问题，跟着提示修复所有报错
• 权限配置检查
  1. iOS端：app.json里必须添加NSBluetoothAlwaysUsageDescription和NSBluetoothPeripheralUsageDescription权限描述
  2. Android端：添加BLUETOOTH、BLUETOOTH_ADMIN、ACCESS_FINE_LOCATION这些权限
• 分析构建日志
  重新运行npx expo run:android或npx expo run:ios，盯着终端输出的日志，找具体的错误信息（比如权限没加、依赖冲突）

终极测试方案 #

如果上面的步骤都没用，就新建一个干净的Expo 51项目，只装@config-plugins/react-native-ble-plx并配置插件，再构建启动。如果这个测试项目能跑起来，说明你原来的项目里有其他依赖冲突或者配置问题。

内容的提问来源于stack exchange，提问作者Pedro Rodrigues