Jenkins构建Ionic/Cordova Android应用遇base-extension元素校验错误

错误原因解析 #

该错误属于XML Schema（XSD）校验失败，提示<base-extension>元素的出现位置不符合规范，XML结构预期应出现codename或vendor元素。这类问题通常是Cordova插件自动注入的配置、Android平台模板文件的XML结构被破坏，或是Gradle与Android SDK版本不兼容导致的。

可行修复方案 #

• 排查第三方插件注入问题：你已移除平台文件中的<base-extension>，但可能是某个cordova插件在构建阶段自动生成并注入了该元素。可以通过逐个禁用插件、重新构建的方式，定位到触发问题的插件，之后要么更新该插件版本，要么修改插件的XML配置模板。
• 统一Java环境版本：你的环境中同时存在OpenJDK 11和javac 1.8，版本不一致可能引发编译异常。建议统一使用OpenJDK 11，确保JAVA_HOME和PATH指向同一版本的JDK。
• 指定兼容的Gradle版本：cordova-android 10.1.2推荐搭配Gradle 7.x版本（如7.0.4）。在项目根目录的build.gradle中修改构建脚本依赖：

  buildscript {
      repositories {
          google()
          mavenCentral()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:7.0.4'
      }
  }
  

• 匹配Android SDK组件版本：确保安装的Android SDK Build Tools版本为30.0.3（cordova-android 10.1.2的兼容版本），可通过以下命令安装：

  sdkmanager "build-tools;30.0.3"
  

• 清理全局Gradle缓存：除工作区缓存外，清理Gradle全局缓存目录~/.gradle/caches，删除后重新触发构建，避免缓存的异常XML文件干扰。
• 检查平台XML模板：找到本地cordova-android的安装目录（通常在node_modules/cordova-android），查看templates文件夹下的AndroidManifest.xml或相关配置文件，确认<base-extension>元素的位置是否符合XSD规范，若位置错误可手动调整。

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