如何在Cordova iOS项目中持久添加-FIRDebugEnabled启动参数？

我之前也碰到过一模一样的问题——手动给Xcode项目加-FIRDebugEnabled参数在Xcode里跑没问题，但一执行cordova run ios就失效，因为Cordova会根据模板重新生成iOS项目的配置文件，手动改的内容直接被覆盖了。

下面是两个靠谱的自动化解决方案，能让所有拉取源码的开发者不用手动操作，每次运行Cordova命令时自动添加上这个调试参数：

方法一：用Cordova After Prepare钩子脚本（推荐） #

Cordova的钩子（Hooks）机制允许我们在项目构建的特定阶段自动执行脚本，这里我们用after_prepare钩子，在Cordova完成项目准备后自动修改iOS的Scheme文件（启动参数就存在这个文件里）。

步骤1：创建钩子脚本 #

在项目根目录下新建hooks/after_prepare文件夹（如果没有的话），然后创建一个名为01_add_firebase_debug_args.js的文件，把下面的代码粘进去：

#!/usr/bin/env node

const fs = require('fs');
const path = require('path');

// 替换成你的Cordova项目名称（就是config.xml里<name>标签的内容）
const projectName = 'YourAppName';
const schemePath = path.join(__dirname, '../platforms/ios', `${projectName}.xcodeproj/xcshareddata/xcschemes/${projectName}.xcscheme`);

// 检查Scheme文件是否存在
if (!fs.existsSync(schemePath)) {
    console.log('⚠️ Scheme文件不存在，跳过添加Firebase调试参数');
    return;
}

// 读取Scheme内容
let schemeContent = fs.readFileSync(schemePath, 'utf8');
const debugArg = '-FIRDebugEnabled';

// 避免重复添加参数
if (schemeContent.includes(debugArg)) {
    console.log('✅ Firebase调试参数已存在，无需重复添加');
    return;
}

// 在LaunchAction的Arguments节点里添加参数
const launchActionRegex = /<LaunchAction([\s\S]*?)>([\s\S]*?)<\/LaunchAction>/;
schemeContent = schemeContent.replace(launchActionRegex, (match, attrs, innerContent) => {
    // 如果没有Arguments节点，先创建一个
    if (!innerContent.includes('<Arguments>')) {
        innerContent += '\n        <Arguments>\n        </Arguments>';
    }
    // 往Arguments里加参数条目
    innerContent = innerContent.replace(/<Arguments>([\s\S]*?)<\/Arguments>/, (argMatch, argInner) => {
        argInner += `\n          <ArgumentEntry\n            argument = "${debugArg}"\n            isEnabled = "YES">\n          </ArgumentEntry>`;
        return `<Arguments>${argInner}</Arguments>`;
    });
    return `<LaunchAction${attrs}>${innerContent}</LaunchAction>`;
});

// 把修改后的内容写回文件
fs.writeFileSync(schemePath, schemeContent, 'utf8');
console.log('✅ 成功添加Firebase调试启动参数-FIRDebugEnabled');

步骤2：给脚本加执行权限（仅Mac/Linux用户） #

打开终端，运行这条命令：

chmod +x hooks/after_prepare/01_add_firebase_debug_args.js

步骤3：测试效果 #

现在执行cordova run ios，脚本会自动帮你修改Scheme文件，不管是用Cordova命令还是打开Xcode运行，-FIRDebugEnabled参数都会生效，而且以后每次构建都不用再手动改了。

方法二：用Cordova Build Config插件（可选） #

如果你不想自己写钩子脚本，可以试试cordova-plugin-build-config插件，不过这个插件主要用来修改plist文件，要加启动参数还是得结合钩子，本质和方法一类似，这里简单说下步骤：

1. 安装插件：

cordova plugin add cordova-plugin-build-config

2. 在项目根目录创建build.json，把钩子脚本关联进去：

{
  "ios": {
    "debug": {
      "hooks": {
        "after_prepare": "./hooks/after_prepare/01_add_firebase_debug_args.js"
      }
    }
  }
}

不过这个方法并没有简化多少，还是推荐直接用方法一，更直接可控。

注意事项 #

• 一定要把脚本里的YourAppName替换成你实际的项目名称，不然找不到Scheme文件。
• 如果你的项目用了自定义Scheme名称，得调整脚本里的Scheme文件路径。
• 钩子脚本会在每次cordova prepare或cordova run ios时自动执行，确保参数不会被Cordova的自动生成过程覆盖。

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