Expo托管项目中如何为iOS Podfile添加指定内容？

Expo托管项目不允许直接手动修改Podfile——因为构建流程中Expo会自动生成并维护这个文件。要添加invertase/firestore-ios-sdk-frameworks所需的Pod配置，得用Expo Config Plugins来注入自定义代码，具体步骤如下：

1. 编写自定义Config Plugin #

在项目根目录新建一个插件文件（比如withFirestoreIOSFramework.js），根据需求选择以下两种写法之一：

写法一：通过属性注入Pod配置

适合标准的Pod声明场景：

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

module.exports = function withFirestoreIOSFramework(config) {
  return withPodfileProperties(config, (config) => {
    // 注入FirebaseFirestore的Pod路径配置
    config.modResults.podfileProperties['pods'] = [
      ...(config.modResults.podfileProperties['pods'] || []),
      {
        name: 'FirebaseFirestore',
        path: '../node_modules/@invertase/firestore-ios-sdk-frameworks',
      },
    ];
    return config;
  });
};

写法二：直接插入Podfile代码行

适合需要自定义Podfile语法（比如添加source、条件判断等）的场景：

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

module.exports = function withFirestoreIOSFramework(config) {
  return withPodfile(config, (config) => {
    // 在Podfile的target块中插入指定的Pod声明
    const updatedContent = config.modResults.contents.replace(
      /target 'ExpoApp' do/,
      `target 'ExpoApp' do\n  pod 'FirebaseFirestore', :path => '../node_modules/@invertase/firestore-ios-sdk-frameworks'`
    );
    config.modResults.contents = updatedContent;
    return config;
  });
};

2. 注册插件到项目配置 #

修改app.json或app.config.js，把自定义插件加入plugins数组：

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

3. 验证与构建 #

• 本地可以执行expo prebuild --platform ios预生成iOS项目文件，检查Podfile是否已包含目标配置；
• 托管项目直接提交代码到Expo构建服务，构建时插件会自动完成Podfile的修改。

注意事项 #

• 确保已安装依赖：npm install @expo/config-plugins --save-dev；
• 不同Expo版本的Config Plugins API可能有细微差异，需对应版本调整代码逻辑。

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