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

Android Studio KMM模板创建项目无法运行,出现Gradle wrapper相关错误

问题原因
  • 你使用的Android Studio Arctic Fox 2020.3.1版本对应的KMM插件与Gradle 7.0存在兼容性缺陷,模板自动生成的gradle-wrapper配置与本地全局Gradle版本映射错误:官方Gradle分发库不存在7.0正式版,仅存在7.0.1、7.0.2等修订版本,版本不匹配导致wrapper生成失败。
  • KMM项目iOS端依赖CocoaPods构建时,默认未开启自动生成Gradle wrapper的配置,缺少gradlew可执行文件时Xcode侧构建流程无法调用Gradle任务,触发对应报错。
  • 手动修改gradle-wrapper.properties中的Gradle版本时,未同步更新根目录build.gradle中Android Gradle插件的版本,插件与Gradle核心版本不匹配导致同步报错。
解决方案
  1. 版本对齐:先将本地全局Gradle版本升级到7.0.3,该版本与Android Studio Arctic Fox 2020.3.1完全兼容,且属于官方正式分发版本。
  2. 手动生成Gradle wrapper:在Android Studio终端切换到项目根目录,执行命令:
    gradle wrapper --gradle-version 7.0.3 --distribution-type bin
    执行成功后项目根目录会自动生成gradlew、gradlew.bat文件,gradle/wrapper目录下的配置文件也会同步更新为正确的版本地址。
  3. 配置CocoaPods自动生成wrapper规则:打开项目根目录的gradle.properties文件,追加如下配置,无需每次执行命令时手动加参数:
    kotlin.native.cocoapods.generate.wrapper=true
  4. 同步项目:点击Android Studio右上角的「Sync Project with Gradle Files」按钮,等待同步完成后即可看到可用的运行配置。
  5. 若iOS端仍有构建异常,打开iosApp目录下的.xcworkspace文件,在Xcode中执行一次「Clean Build Folder」后再回到Android Studio运行即可。

内容的提问来源于stack exchange,提问作者eqtèöck

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.04 15:45:01