如何在Ionic项目中持久修改config.xml，保留Firebase通用链接配置？

我之前也碰到过一模一样的坑！每次手动在config.xml里加完通用链接配置，一运行构建命令就被清掉，头疼得不行。这大概率是Cordova或Ionic的构建流程在自动处理配置时，把手动添加的内容覆盖了。下面是几个我亲测有效的解决办法：

1. 使用Cordova Universal Links插件管理配置 #

手动修改config.xml很容易被构建流程覆盖，不如用官方推荐的插件来维护这些配置。cordova-plugin-universal-links专门用来处理通用链接，它会确保你的配置在构建过程中被正确保留：

• 先安装插件：

  cordova plugin add cordova-plugin-universal-links --save
  

• 然后把你的通用链接配置放到对应平台的标签下（比如iOS和Android），而不是直接放在根节点：

  <platform name="ios">
      <universal-links>
          <host name="abc123.app.goo.gl" scheme="https" />
          <host name="my-app.firebaseapp.com" scheme="https">
              <path url="/__/auth/callback"/>
          </host>
      </universal-links>
  </platform>
  
  <platform name="android">
      <universal-links>
          <host name="abc123.app.goo.gl" scheme="https" />
          <host name="my-app.firebaseapp.com" scheme="https">
              <path url="/__/auth/callback"/>
          </host>
      </universal-links>
  </platform>
  

  这样插件会在构建时自动把这些配置同步到原生项目里，不会被Ionic/Cordova的自动清理机制干掉。

2. 调整Ionic的构建同步设置 #

有时候ionic cordova prepare命令会根据项目的配置文件重置config.xml，你可以试试这些调整：

• 检查项目根目录的ionic.config.json，看看有没有overwriteConfig这类选项，如果有，把它设为false，避免Ionic自动覆盖config.xml。
• 尝试用纯Cordova命令代替Ionic的命令：修改完config.xml后，运行cordova prepare而不是ionic cordova prepare，跳过Ionic的额外配置处理步骤。

3. 用Cordova Hook脚本强制保留配置 #

如果上面的方法都不管用，那就写个Hook脚本，让它在每次构建前自动把通用链接配置插入到config.xml里，相当于“硬塞”进去：

• 在项目的hooks/before_prepare目录下创建一个add-universal-links.js文件（如果没有hooks目录就自己建）。
• 脚本内容如下（需要先安装xml2js依赖：npm install xml2js --save-dev）：

  const fs = require('fs');
  const xml2js = require('xml2js');
  
  module.exports = function(context) {
      const configPath = `${context.opts.projectRoot}/config.xml`;
      const parser = new xml2js.Parser({ explicitArray: false });
      const builder = new xml2js.Builder();
  
      fs.readFile(configPath, 'utf8', (err, data) => {
          if (err) throw err;
          parser.parseString(data, (parseErr, result) => {
              if (parseErr) throw parseErr;
  
              // 检查是否已存在通用链接配置
              let universalLinks = result.widget['universal-links'];
              if (!universalLinks) {
                  universalLinks = {
                      host: [
                          { $: { name: 'abc123.app.goo.gl', scheme: 'https' } },
                          {
                              $: { name: 'my-app.firebaseapp.com', scheme: 'https' },
                              path: { $: { url: '/__/auth/callback' } }
                          }
                      ]
                  };
                  result.widget['universal-links'] = universalLinks;
              }
  
              const updatedXml = builder.buildObject(result);
              fs.writeFile(configPath, updatedXml, 'utf8', (writeErr) => {
                  if (writeErr) throw writeErr;
                  console.log('✅ Universal links config added successfully');
              });
          });
      });
  };
  

• 给脚本加执行权限（Linux/macOS下）：chmod +x hooks/before_prepare/add-universal-links.js
  这样每次运行构建命令前，脚本都会检查并确保你的通用链接配置存在，再也不怕被清除了。

4. 检查Firebase插件的冲突 #

如果你用了cordova-plugin-firebase或者@ionic-native/firebase这类Firebase相关插件，它们可能会自动处理通用链接的配置，导致你手动加的内容被覆盖。建议查看插件的官方文档，看看是否可以直接通过插件的配置项来设置这些通用链接，比如用<config-file>或者<preference>标签在config.xml里配置，这样插件会自己维护这些内容，不会和你的手动配置冲突。

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