Expo Android构建失败：react-native-peripheral模块兼容问题求助

以下是针对你遇到的react-native-peripheral仅支持iOS但Android构建仍报错的几种可行方案：

方案1：通过Metro配置排除iOS专属模块 #

Metro打包器在构建时会扫描所有依赖，即使你用条件引入，静态解析阶段还是会尝试查找该模块。可以在metro.config.js里添加黑名单，让Android构建时忽略这个包：

const { getDefaultConfig } = require('expo/metro-config');
const config = getDefaultConfig(__dirname);

// 给Android构建添加黑名单
if (process.env.EXPO_OS === 'android') {
  config.resolver.blacklistRE = /react-native-peripheral\/.*/;
}

module.exports = config;

方案2：用Babel别名映射空模块 #

安装babel-plugin-module-resolver，然后在Babel配置里把iOS专属模块在Android端映射到一个空模块，避免构建时找不到依赖：

1. 安装插件：

npm install babel-plugin-module-resolver --save-dev

2. 修改babel.config.js：

const { Platform } = require('react-native');

module.exports = function(api) {
  api.cache(true);
  return {
    presets: ['babel-preset-expo'],
    plugins: [
      [
        'module-resolver',
        {
          alias: {
            // Android端映射到空模块
            'react-native-peripheral': Platform.OS === 'ios' 
              ? 'react-native-peripheral' 
              : './src/mocks/empty-peripheral.js',
          },
        },
      ],
    ],
  };
};

3. 创建src/mocks/empty-peripheral.js空模块：

// 空导出，匹配原模块的导出结构避免运行时错误
export default {};

方案3：改用动态导入替代静态require #

静态require会在构建阶段被解析，而动态import()是运行时加载，能绕过构建时的依赖检查。注意处理异步加载的状态：

let Peripheral = null;

if (Platform.OS === 'ios') {
  // 动态导入，仅iOS端加载
  import('react-native-peripheral').then(module => {
    Peripheral = module.default;
    // 这里可以触发状态更新，比如设置加载完成
  });
}

// 使用时先判断Peripheral是否存在
if (Peripheral) {
  // 执行iOS专属逻辑
}

方案4：Bare Workflow下直接排除Android端依赖 #

如果你的项目是Expo Bare Workflow，可以直接在Android的Gradle配置里排除该模块：

1. 修改android/settings.gradle，移除对react-native-peripheral的引入：

include ':app'
// 删掉 include ':react-native-peripheral' 和 project(':react-native-peripheral').projectDir = ... 这两行

2. 修改android/app/build.gradle，确保依赖里不包含该模块：

dependencies {
  // 移除 implementation project(':react-native-peripheral')
}

内容的提问来源于stack exchange，提问作者Verc James