Ionic Android构建失败：CordovaLib模块Gradle错误求助

问题描述 #

已多方查找但未找到该错误相关信息，已安装Android Studio，尝试过多个SDK，环境变量也已正确配置，但构建仍失败。错误出现在build.gradle第40行apply plugin: 'com.android.library'，具体报错详情如下：

FAILURE: Build failed with an exception.
- 位置：构建文件 '/home/user/Documents/app/platforms/android/CordovaLib/build.gradle' 第40行

A problem occurred evaluating project ':CordovaLib'.
org.gradle.api.Project.getPluginManager()Lorg/gradle/api/plugins/PluginManager;
Run with --stacktrace option to get the stack trace.
Run with --info or --debug option to get more log output.
at ChildProcess.whenDone (/home/user/app/platforms/android/cordova/node_modules/cordova-common/src/superspawn.js:169:23)
at ChildProcess.emit (events.js:182:13)
at maybeClose (internal/child_process.js:947:16)
at Process.ChildProcess._handle.onexit (internal/child_process.js:236:5)
(node:2259) UnhandledPromiseRejectionWarning: Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). (rejection id: 1)
(node:2259) [DEP0018] DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.

解决方案 #

我之前处理过完全相同的报错，这本质是Gradle版本与Cordova/CordovaLib的兼容性不匹配导致的——getPluginManager()这个方法的签名在不同Gradle版本中发生了变化，旧版CordovaLib的构建脚本和高版本Gradle不兼容，反之亦然。下面是一步步的解决办法：

1. 确认Cordova版本对应的Gradle要求

不同Cordova版本对Gradle和Android Gradle插件有严格的版本匹配要求：

• Cordova 9.x：建议使用Gradle 6.1.1 + Android Gradle插件4.0.1
• Cordova 10.x+：需要Gradle 6.7+ + Android Gradle插件4.2.0+
  先运行cordova -v查看你的Cordova版本，再对应调整Gradle版本。

2. 强制指定Cordova使用的Gradle版本

找到项目中Android平台的Gradle wrapper配置文件：platforms/android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl为对应版本的Gradle包地址，比如针对Cordova 9：

distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-all.zip

3. 调整CordovaLib的Android Gradle插件版本

打开报错的/home/user/Documents/app/platforms/android/CordovaLib/build.gradle文件：

• 找到buildscript下的dependencies块，修改classpath 'com.android.tools.build:gradle:x.x.x'的版本号，使其和你指定的Gradle版本匹配（比如Gradle 6.1.1对应4.0.1）
• 另外可以尝试把第40行的apply plugin: 'com.android.library'替换为Gradle的新插件应用语法：

  plugins {
      id 'com.android.library'
  }
  

  这能解决部分新旧语法不兼容的问题。

4. 清理缓存后重新构建

运行以下命令清理构建缓存，再重新尝试构建：

cordova clean android
cordova build android --verbose

--verbose参数能输出更详细的日志，方便排查后续可能出现的问题。

额外排查点

• 检查环境变量GRADLE_HOME是否指向了正确的Gradle版本，避免全局Gradle版本和项目要求冲突
• 如果是刚升级了Android Studio，可能默认使用了最新版Gradle，此时要么降级Gradle到Cordova兼容的版本，要么升级Cordova到支持该Gradle版本的最新稳定版

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