Azure DevOps Pipeline中Android Gradle构建失败求助

一、先明确JDK与Android Gradle插件的对应关系 #

这是核心前提，版本不匹配必然报错：

• Android Gradle Plugin (AGP) 7.0.x ~ 7.4.x → 需JDK 11
• AGP 7.5.x ~ 8.1.x → 需JDK 17
• AGP 8.2+ → 支持JDK 17或19（优先17，兼容性更好）

先打开项目根目录的build.gradle（Project级），找到com.android.tools.build:gradle的版本，确定对应JDK版本。

二、修复JDK版本配置无效问题 #

不管用预装JDK还是Java Tool Installer，关键是让Gradle任务能读取到正确的JDK路径：

方案1：使用代理预装的Java 19（需AGP版本支持） #

放弃jdkVersionOption，直接指定JDK实际路径：

- task: Gradle@3
  inputs:
    workingDirectory: ''
    gradleWrapperFile: 'gradlew'
    tasks: 'assembleRelease'
    publishJUnitResults: false
    testResultsFiles: '**/TEST-*.xml'
    javaHomeOption: 'Path'
    jdkDirectory: '/usr/lib/jvm/java-19-openjdk-amd64' # 需替换为代理上Java 19的真实路径
    options: '-Xmx4096m'

如果不知道代理上的Java路径，先加脚本任务查询：

- script: |
    update-alternatives --list java
  displayName: '查看已安装Java路径'

运行一次流水线，从输出里复制对应路径填入jdkDirectory。

方案2：用Java Tool Installer强制安装指定JDK #

必须将Java Tool Installer放在Gradle任务之前，并确保后续任务使用该JDK：

- task: JavaToolInstaller@0
  inputs:
    versionSpec: '17' # 替换为你需要的JDK版本
    jdkArchitectureOption: 'x64'
    jdkSourceOption: 'PreInstalled' # 代理有预装则选这个，无预装可选AzureStorage/AdoptOpenJDK
    jdkDestinationDirectory: '$(agent.toolsDirectory)/jdk17'
    cleanDestinationDirectory: true

- task: Gradle@3
  inputs:
    workingDirectory: ''
    gradleWrapperFile: 'gradlew'
    tasks: 'assembleRelease'
    javaHomeOption: 'Path'
    jdkDirectory: '$(agent.toolsDirectory)/jdk17' # 与上面的路径保持一致

三、修复Gradle任务构建错误 #

解决JDK问题后，再排查Gradle本身的问题：

1. 确认gradlew文件存在：项目根目录必须有gradlew（Linux/macOS）和gradlew.bat（Windows），本地运行gradle wrapper生成后提交到代码库。
2. 指定具体构建任务：避免用模糊的build，改用assembleRelease或assembleDebug，减少不必要的步骤。
3. 增加内存配置：Android构建耗内存，在Gradle任务的options里添加-Xmx4096m（或更大值），避免内存溢出。
4. 检查仓库配置：若项目依赖私有仓库，需在gradle.properties里设置仓库地址，或在Pipeline中配置代理权限。

四、新手调试技巧 #

• 先在本地跑通构建：本地执行./gradlew assembleRelease成功后，再放到Pipeline中，排除代码本身问题。
• 分步验证：先加脚本任务检查Java版本（java -version）、Gradle版本（./gradlew --version），确认环境正确后再跑构建。
• 查看完整错误日志：Pipeline报错时，进入"Logs"标签查看完整输出，最上方的红色错误信息通常是问题核心（如依赖下载失败、版本不兼容）。

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