EAS构建iOS开发版本失败：Pods安装遇静态库集成错误

问题核心 #

使用eas build --profile development --platform ios构建时，Firebase相关Swift Pod无法作为静态库集成，原因是依赖的第三方库未定义模块映射，导致Swift无法导入这些库。

解决方案 #

方案1：全局启用模块化头文件（Managed Workflow推荐） #

通过expo-build-properties插件全局开启use_modular_headers!：

1. 安装插件：

npx expo install expo-build-properties

2. 在app.json或app.config.js中添加插件配置：

{
  "expo": {
    "plugins": [
      [
        "expo-build-properties",
        {
          "ios": {
            "useModularHeaders": true
          }
        }
      ]
    ]
  }
}

3. 重新执行构建命令：

eas build --profile development --platform ios

方案2：针对特定依赖启用模块化头文件（避免全局冲突） #

如果全局开启导致其他依赖冲突，可通过自定义插件仅为报错的依赖开启模块化头文件：

1. 创建自定义插件文件withModularHeaders.js：

const { withPodfileProperties } = require('@expo/config-plugins');

module.exports = function withModularHeaders(config) {
  return withPodfileProperties(config, (props) => {
    // 为指定依赖开启模块化头文件
    props.modResults.podfileProperties.pods = {
      GoogleUtilities: { modular_headers: true },
      FirebaseStorageInternal: { modular_headers: true },
      FirebaseAppCheckInterop: { modular_headers: true },
      FirebaseAuthInterop: { modular_headers: true },
      FirebaseCore: { modular_headers: true },
      FirebaseCoreExtension: { modular_headers: true }
    };
    return props;
  });
};

2. 在app.json中注册插件：

{
  "expo": {
    "plugins": ["./withModularHeaders.js"]
  }
}

3. 重新执行构建命令。

方案3：Prebuild后手动修改Podfile（Bare Workflow适用） #

1. 生成iOS原生项目文件：

npx expo prebuild --platform ios

2. 打开ios/Podfile，添加以下配置（二选一）：

# 全局开启
use_modular_headers!

# 或仅为指定依赖开启
pod 'GoogleUtilities', :modular_headers => true
pod 'FirebaseStorageInternal', :modular_headers => true
pod 'FirebaseAppCheckInterop', :modular_headers => true
pod 'FirebaseAuthInterop', :modular_headers => true
pod 'FirebaseCore', :modular_headers => true
pod 'FirebaseCoreExtension', :modular_headers => true

3. 本地验证依赖安装（可选）：

cd ios && pod install && cd ..

4. 执行构建命令：

eas build --profile development --platform ios

原理说明 #

开启modular_headers会让指定的Objective-C依赖生成模块映射文件（Module Map），Swift静态库需要通过模块映射才能正确导入这些依赖，从而解决静态库集成的兼容性问题。

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