Gradle 8.x迁移后AGCP依赖兼容问题求助（非回退Gradle7方案）

算力阿峰

2026-7-16

解决方案：Gradle 8.x 兼容华为AGCP插件问题

针对你遇到的com.huawei.agconnect:agcp:1.9.0.300不兼容Gradle 8.x的问题（报错API 'android.registerTransform' is removed），除了回退Gradle版本，还有以下几种可行方案：

1. 优先等待华为官方更新AGCP插件

华为已明确会在后续AGCP版本中适配Gradle 8.x，可关注华为AGC平台的版本更新日志，推出兼容版本后直接升级即可。

2. 临时禁用AGCP的Transform逻辑（仅适用于不需要该功能的项目）

如果你的项目仅使用AGC基础功能（如远程配置、认证、云存储等），未依赖AGCP插件的Transform能力（例如动态依赖注入、字节码修改相关功能），可通过以下方式绕过错误：

方法A：在`gradle.properties`中添加兼容配置

android.enableTransformsArtifact=false

方法B：通过Gradle脚本拦截过时API调用

在项目根目录的build.gradle中添加以下代码：

allprojects {
    gradle.beforeProject { project ->
        project.plugins.withId('com.huawei.agconnect') {
            // 替换过时的registerTransform方法为空实现
            def androidExt = project.extensions.findByName('android')
            if (androidExt) {
                androidExt.metaClass.registerTransform = { -> }
            }
        }
    }
}

注意：此方法会跳过AGCP插件的Transform执行，若项目依赖该功能（例如AGC动态能力），可能导致功能异常。