Android Gradle无法同步Chaquopy新版本问题求助

问题分析 #

报错核心原因是Chaquopy 14.0+仅发布在官方专属Maven仓库，且Gradle 8.0对插件仓库的解析逻辑有调整，同时需确保AGP（Android Gradle Plugin）版本与Chaquopy、Gradle的兼容性匹配。

解决方案 #

1. 确认版本兼容性 #

Chaquopy 14.0+的最低要求：

• AGP版本 ≥7.4.0（Gradle 8.0建议搭配AGP 8.0.x版本）
• Gradle版本 ≥7.5.0（你的Gradle 8.0符合要求）

检查根build.gradle中的AGP版本，确保与Gradle版本匹配：

plugins {
    id 'com.android.application' version '8.0.0' apply false // 适配Gradle 8.0的AGP版本
    id 'com.chaquo.python' version '15.0.0' apply false
}

2. 修正插件仓库配置 #

Gradle 8.0的插件解析在settings.gradle的pluginManagement阶段完成，必须在此处添加Chaquopy的官方仓库，而非仅在根build.gradle中配置。

修改settings.gradle（或settings.gradle.kts）：

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
        maven { url "https://chaquo.com/maven" } // 必须添加这行，用于插件解析
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url "https://chaquo.com/maven" } // 此处也需添加，用于Python依赖下载
    }
}

rootProject.name = "RunPython"
include ':app'

3. 清理缓存并重新同步 #

• 命令行执行：gradlew cleanBuildCache（Windows）或./gradlew cleanBuildCache（Mac/Linux）
• 在Android Studio中点击File → Invalidate Caches...，勾选Invalidate and Restart

为什么Chaquopy 13.0能正常工作？ #

Chaquopy 13.0及更早版本曾在Gradle Central Plugin Repository有镜像发布，无需额外配置专属仓库即可解析；但14.0+版本仅在官方Maven仓库发布，必须显式配置仓库地址。

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