Construct 2项目Cordova CLI构建Android APK报错及配置方案求助

一、前期环境准备 #

• 安装JDK：必须用JDK 11，不要用JDK 8或过高版本（比如17），否则会和Gradle插件版本冲突。
• 配置Android SDK：
  • 安装Android Studio，通过SDK Manager安装以下组件：
    • Android SDK Platform（选API 33或34，Cordova官方推荐的目标版本）
    • Android Build Tools（选33.0.2，和SDK平台版本匹配）
    • Android SDK Command-line Tools（选最新版）
  • 设置环境变量：
    • ANDROID_HOME设为你的SDK安装路径（比如C:\SDKLAGI）
    • 把%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\cmdline-tools\latest\bin加到系统PATH里
• 安装Node.js和Cordova：
  • 安装Node.js的LTS版本（比如18.x）
  • 打开命令提示符，执行 npm install -g cordova 安装Cordova CLI

二、Construct 2 项目导出 #

• 打开你的Construct 2项目，点击顶部菜单File -> Export project
• 导出选项选择Cordova (Android, iOS, Windows)
• 填写应用名称、包名（必须是反向域名格式，比如com.yourname.adventuredark），选好导出路径后点击Export，将导出的压缩包解压到本地目录

三、Cordova 项目初始化与构建 #

• 打开命令提示符，导航到解压后的项目目录（比如C:\Users\USER\Documents\AdvDark）
• 初始化Cordova项目（如果导出的项目未自动生成配置）：

  cordova create . com.yourname.adventuredark "Adventure In The Dark"
  

  提示覆盖www文件夹时，选择保留现有内容即可
• 添加Android平台：

  cordova platform add android@11.0.0
  

  指定11.0.0版本是为了避免最新版本的兼容问题，该版本对应Gradle插件7.4.2
• 检查环境是否符合要求：执行 cordova requirements android，确保所有依赖项都满足
• 构建APK：

  cordova build android
  

  构建成功后，APK文件位于platforms\android\app\build\outputs\apk\debug目录下

四、当前报错的修复步骤 #

你遇到的报错核心是Java版本不兼容：Gradle插件com.android.tools.build:gradle:7.4.2要求使用Java 11，但你当前使用的是Java 8，再加上Gradle版本与插件的匹配问题，导致构建失败。按以下步骤修复：

1. 切换到JDK 11

   • 卸载当前的JDK 8，安装JDK 11（Oracle OpenJDK或开源OpenJDK均可）
   • 配置环境变量：
     • JAVA_HOME设为JDK 11的安装路径（比如C:\Program Files\Java\jdk-11.0.18）
     • 把%JAVA_HOME%\bin加到系统PATH最前面，确保系统优先使用JDK 11
   • 验证：执行 java -version，确认输出为Java 11版本

2. 调整Gradle版本适配插件

   • 打开项目中的platforms\android\gradle\wrapper\gradle-wrapper.properties文件
   • 将distributionUrl修改为对应Gradle 7.5的地址：

     distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
     

   （Gradle插件7.4.2与Gradle 7.5完美匹配，之前使用7.6会出现版本不兼容提示）

3. 重新构建

   • 先清理构建缓存：

     cordova clean android
     

   • 再次执行构建命令：

     cordova build android
     

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