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核心版本不匹配导致同步报错。
解决方案
- 版本对齐:先将本地全局Gradle版本升级到7.0.3,该版本与Android Studio Arctic Fox 2020.3.1完全兼容,且属于官方正式分发版本。
- 手动生成Gradle wrapper:在Android Studio终端切换到项目根目录,执行命令:
gradle wrapper --gradle-version 7.0.3 --distribution-type bin
执行成功后项目根目录会自动生成gradlew、gradlew.bat文件,gradle/wrapper目录下的配置文件也会同步更新为正确的版本地址。 - 配置CocoaPods自动生成wrapper规则:打开项目根目录的gradle.properties文件,追加如下配置,无需每次执行命令时手动加参数:
kotlin.native.cocoapods.generate.wrapper=true - 同步项目:点击Android Studio右上角的「Sync Project with Gradle Files」按钮,等待同步完成后即可看到可用的运行配置。
- 若iOS端仍有构建异常,打开iosApp目录下的.xcworkspace文件,在Xcode中执行一次「Clean Build Folder」后再回到Android Studio运行即可。
内容的提问来源于stack exchange,提问作者eqtèöck
相关产品推荐
相关产品推荐

