如何让Cordova插件同时兼容cordova@7.1.0与cordova@8.0.0版本？

我之前踩过不少Cordova跨版本适配的坑，这个AndroidManifest路径差异的问题本质是Cordova 8.0.0升级了cordova-android到7.x版本，把项目从单模块改成了多模块结构（新增app子模块），导致Manifest的存放位置变了。给你两个最实用的解决方案：

方案一：在plugin.xml中用条件判断指定路径（最简洁） #

直接在插件的plugin.xml里针对不同的cordova-android版本，配置不同的config-file目标路径，不需要额外写脚本。

<platform name="android">
    <!-- 适配Cordova 7.1.0（对应cordova-android 6.x） -->
    <config-file 
        target="AndroidManifest.xml" 
        parent="/manifest" 
        if="cordova-android < 7.0.0"
    >
        <!-- 这里放你需要添加的Manifest配置，比如权限、组件声明等 -->
        <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
        <activity android:name="com.yourplugin.YourActivity" />
    </config-file>

    <!-- 适配Cordova 8.0.0+（对应cordova-android 7.x+） -->
    <config-file 
        target="app/src/main/AndroidManifest.xml" 
        parent="/manifest" 
        if="cordova-android >= 7.0.0"
    >
        <!-- 复制上面的配置内容即可，保证两个版本的Manifest都能得到正确修改 -->
        <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
        <activity android:name="com.yourplugin.YourActivity" />
    </config-file>
</platform>

这个方式利用了Cordova的if条件属性，会自动根据当前项目的cordova-android版本选择对应的配置块，完美解决路径问题。

方案二：用钩子脚本动态处理（适合复杂修改场景） #

如果你的插件需要对Manifest做复杂的动态修改（比如根据用户配置调整权限），可以写一个钩子脚本自动识别路径。

1. 在插件目录下创建hooks/before_build.js文件，内容如下：

module.exports = function(context) {
    const fs = require('fs');
    const path = require('path');
    const projectRoot = context.opts.projectRoot;
    const cordovaAndroidVersion = context.opts.cordova.platforms.android.version;
    
    // 确定Manifest路径
    let manifestPath;
    if (parseInt(cordovaAndroidVersion.split('.')[0]) < 7) {
        // Cordova 7.1.0 对应的路径
        manifestPath = path.join(projectRoot, 'platforms/android/AndroidManifest.xml');
    } else {
        // Cordova 8.0.0+ 对应的路径
        manifestPath = path.join(projectRoot, 'platforms/android/app/src/main/AndroidManifest.xml');
    }

    // 检查文件是否存在，避免报错
    if (!fs.existsSync(manifestPath)) {
        console.error(`[YourPlugin] 找不到AndroidManifest.xml: ${manifestPath}`);
        return;
    }

    // 这里写你的Manifest修改逻辑，比如读取内容、替换节点等
    let manifestContent = fs.readFileSync(manifestPath, 'utf8');
    // 示例：添加一个权限
    if (!manifestContent.includes('android.permission.WRITE_EXTERNAL_STORAGE')) {
        manifestContent = manifestContent.replace(
            '</manifest>',
            '    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />\n</manifest>'
        );
        fs.writeFileSync(manifestPath, manifestContent, 'utf8');
        console.log(`[YourPlugin] 已成功添加存储权限到: ${manifestPath}`);
    }
};

2. 在plugin.xml中注册这个钩子：

<platform name="android">
    <hook type="before_build" src="hooks/before_build.js" />
</platform>

这样每次执行cordova build android时，脚本会自动判断版本并找到正确的Manifest文件进行修改。

额外注意事项 #

• 测试时一定要分别在Cordova 7.1.0和8.0.0的环境下验证，避免出现遗漏。
• 如果插件还涉及其他平台的适配，记得同步检查对应平台的版本差异。

内容的提问来源于stack exchange，提问作者Aman Kumar Aggarwal