Cordova执行prepare后Podfile的iOS平台版本未更新问题求助

架构老林

2026-7-19

解决Cordova项目Podfile iOS平台版本不更新的问题

常见解决步骤：

1. 重新生成iOS平台

Cordova缓存可能导致配置不生效，先移除再重建平台：

移除iOS平台：cordova platform remove ios
清理项目缓存：cordova clean ios
重新添加iOS平台（可指定版本，比如最新稳定版）：cordova platform add ios

2. 排查插件强制设置的版本

部分插件的plugin.xml会硬编码最低iOS版本，覆盖全局配置：

进入项目的plugins目录，逐个查看插件的plugin.xml文件，搜索deployment-target字段
若发现插件设置的版本低于12.4，优先更新该插件到最新版；无法更新则手动修改插件plugin.xml里的对应值，之后重新执行cordova prepare ios

3. 用Cordova钩子自动修改Podfile

如果上述方法无效，可通过钩子脚本在Podfile生成后自动替换版本号：

项目根目录新建hooks/after_prepare文件夹（不存在则创建）
在该文件夹下创建01_modify_podfile.js，写入以下代码：

module.exports = function(context) {
    const fs = require('fs');
    const path = require('path');
    const podfilePath = path.join(context.opts.projectRoot, 'platforms/ios/Podfile');

    fs.readFile(podfilePath, 'utf8', (err, data) => {
        if (err) return console.error(err);
        const updatedContent = data.replace(/platform :ios, '11.0'/g, "platform :ios, '12.4'");
        fs.writeFile(podfilePath, updatedContent, 'utf8', (err) => {
            if (err) return console.error(err);
        });
    });
};