You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Unity打包Android报错:配置:launcher失败 找不到gradle:6.1.1

问题核心表现

Unity 执行Android平台打包构建时失败,Gradle在配置:launcher项目阶段抛出异常,构建启动1秒即终止,核心错误为无法解析:launcher:classpath配置下的依赖com.android.tools.build:gradle:6.1.1,Gradle先后在谷歌Android Maven仓库、jcenter仓库检索该依赖均未找到对应产物。

问题根因
  • 不存在com.android.tools.build:gradle:6.1.1这个正式发布的版本:该依赖对应Android Gradle Plugin(简称AGP),其6.x分支的首个正式发布版本为6.1.2,从未发布过6.1.1版本的公开产物,因此无论配置哪个公开仓库都无法拉取到该包。高频触发场景是开发者混淆Gradle本体版本和AGP版本,误将Gradle 6.1.1的版本号填写到AGP依赖声明位置。
  • Gradle配置被异常篡改:要么是手动修改Unity自定义Gradle模板时写错版本号,要么是接入的第三方Unity插件、SDK在Editor脚本里强行写入了错误的AGP版本,覆盖了Unity默认的正确配置。
  • 仓库源配置失效:jcenter仓库早已停止维护,大量历史包被移除,部分老版本Unity默认未配置mavenCentral仓库,就算版本正确也可能出现依赖拉取失败问题。
解决步骤

按以下优先级操作即可修复:

  1. 修正AGP版本配置
    • 打开Unity的Player Settings -> Android板块 -> Publishing Settings,勾选Custom Base Gradle Template、Custom Launcher Gradle Template选项。
    • 进入项目目录下的Assets/Plugins/Android路径,找到baseProjectTemplate.gradle、launcherTemplate.gradle两个文件,全局搜索com.android.tools.build:gradle:开头的依赖行,将后面的版本号替换为当前Unity版本匹配的AGP版本:Unity 2020.3.x系列对应AGP 4.0.1,Unity 2021.3.x系列对应AGP 7.1.2,Unity 2022.3.x系列对应AGP 7.4.2,禁止填写不存在的版本号。
    • 如果是第三方插件自动注入的错误版本,定位到对应插件的Editor脚本,注释掉写死AGP版本的代码,或在Gradle模板中添加强制版本配置覆盖错误声明。
  2. 补全Gradle仓库配置
    • 打开baseProjectTemplate.gradle文件,分别找到buildscript.repositories和allprojects.repositories两个代码块,按顺序添加google()、mavenCentral()仓库源,将已停止服务的jcenter()配置放到仓库列表末尾或直接删除。
    • 内网开发环境下,提前将对应版本的AGP及关联依赖上传到内网私有Maven仓库,将私有源地址添加到仓库列表的最顶部。
  3. 校验版本匹配关系
    • AGP和Gradle本体存在严格的版本绑定要求,比如AGP 4.0.x对应Gradle 6.1.1,AGP 7.x系列对应Gradle 7.x系列。修改完AGP版本后,打开Unity的Preferences -> External Tools面板,确认当前Unity调用的Gradle版本和AGP要求的版本匹配,避免出现版本兼容问题。
  4. 清理缓存重试
    • 关闭Unity编辑器,删除项目根目录下的Library、Temp、Obj缓存文件夹,再删除当前用户目录下.gradle/caches路径下的所有缓存文件,重新打开Unity执行构建即可。

内容的提问来源于stack exchange,提问作者정원진

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.01 23:45:36