【Compose multiplatform教程06】用IDEA编译Compose Multiplatform常见问题
当我们从Kotlin Multiplatform Wizard | JetBrains 下载ComposeMultiplatform项目时
会遇到无法正常编译/运行的情况,一般网页和桌面是可以正常编译的,
我这里着重解决如下问题
1:Gradle版本不兼容或者Gradle连接超时
2:JDK版本不兼容
3:Gradle依赖库连接超时-替换成国内镜像
4:Android环境编译
5:Android 运行到手机/模拟器
6:IOS平台(后续补充)
1:Gradle版本不兼容或者Gradle连接超时
The project is using an incompatible version (AGP 8.5.2) of the Android Gradle plugin. Latest supported version is AGP 8.2.0
See Android Studio & AGP compatibility options.
[Experimental] Enable sync with future AGP version.
该项目正在使用不兼容版本(Android Gradle 插件 8.5.2 版)的 Android Gradle 插件。所支持的最新版本是 Android Gradle 插件 8.2.0 版。
查看 Android Studio 与 Android Gradle 插件的兼容性选项。
[实验性] 启用与未来 Android Gradle 插件版本的同步功能。
下载最新版本IntelliJ IDEAIntelliJ IDEA 毫无疑问是软件开发者的首选 IDE。 It makes Java and Kotlin development a more productive and enjoyable experience.https://www.jetbrains.com.cn/idea/promo/?utm_source=baidu&utm_medium=cpc&utm_campaign=cn-bai-br-intellij-ex-pc&utm_content=intellij-core&utm_term=idea
找到gradle/wrapper/gradle-wrapper.properties 文件将修改distributionUrl为合适的版本,我们用由于国外很多gradle依赖链接需要翻墙,我们可以用ai帮我们找合适的地址:
(Gradle国内镜像)南京大学镜像站 下载目录https://mirrors.nju.edu.cn/gradle/我们可以找个相对合适的版本8.9 直接替换链接,如图 右键复制地址
distributionUrl=https\://services.gradle.org/distributions/gradle-8.9-bin.zip 修改为https://mirrors.nju.edu.cn/gradle/gradle-8.9-bin.ziphttps://mirrors.nju.edu.cn/gradle/gradle-8.9-bin.zip然后点击小象load图标 load Gradle Changes 同步 快捷键是(ctrl+shift+o)
2:JDK版本不兼容
Your build is currently configured to use Java 21.0.2 and Gradle 8.5.
Possible solution:
- Use Java 17 as Gradle JVM: Open Gradle settings
- Upgrade Gradle wrapper to 8.9 version and re-import the project
您的构建当前配置为使用 Java 21.0.2 版本和 Gradle 8.5 版本。
可能的解决方案:
- 将 Java 17 用作 Gradle 的 Java 虚拟机(JVM):打开 Gradle 设置。
- 将 Gradle 包装器升级到 8.5 版本,然后重新导入项目。
打开工程结构窗口将SDK修改17
File->Project Structure->Project->SDK: 选择对应版本17 没有的话选择Edit 选择Add SDK选择本地JDK版本,为什么用官方JDK,因为有时候编译打包会莫名其妙的报错,用官网就没问题(血泪的教训)
JDK17下载(强烈推荐用官网的JDK)https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html
打开Settings输入Gradle JVM找到Build->BuildTools->Gradle->Gradle JVM将版本改成17
下载JDK1Java Archive Downloadshttps://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html下载对应的系统的版本例如
找到项目根目录local.properties文件添加本地配置属性
org.gradle.java.home=C\:\\Program Files\\Java\\jdk-17
3:该项目正在使用不兼容版本(安卓 Gradle 插件 8.5.2 版)的安卓 Gradle 插件。
The project is using an incompatible version (AGP 8.5.2) of the Android Gradle plugin. Latest supported version is AGP 8.2.0
See Android Studio & AGP compatibility options.
[Experimental] Enable sync with future AGP version.
该项目正在使用不兼容版本(安卓 Gradle 插件 8.5.2 版)的安卓 Gradle 插件。所支持的最新版本是安卓 Gradle 插件 8.2.0 版。
查看安卓工作室与安卓 Gradle 插件的兼容性选项。
[实验性] 启用与未来安卓 Gradle 插件版本的同步功能。
解决办法1:
[实验性的] 启用与未来 Android Gradle 插件(AGP)版本的同步。我们可以打开Settings勾选
Enable sync with future AGP version (Experimental)
然后再点击小象load图标 load Gradle Changes 同步 快捷键是(ctrl+shift+o)
解决办法2:下载最新的IDEA版本
IntelliJ IDEA – 领先的 Java 和 Kotlin IDEhttps://www.jetbrains.com.cn/idea/promo/?utm_source=baidu&utm_medium=cpc&utm_campaign=cn-bai-br-intellij-ex-pc&utm_content=intellij-core&utm_term=idea
3:Gradle依赖库连接超时-替换成国内镜像
- 在 Windows 系统中,hosts 文件位于 C:\Windows\System32\Drivers\etc 文件夹中,以记事本方式打开后,在文件底部添加类似 “20.205.243.166 github.com” 的内容,保存并关闭文件12.
- 更改 DNS 服务器:可以尝试更改 DNS 服务器地址为公共 DNS 服务,如谷歌的 8.8.8.8 和 8.8.4.4 或Cloudflare的 1.1.1.1 和 1.0.0.1。在计算机的控制面板中找到网络和 Internet 设置,点击正在使用的网络连接,进入其属性设置,在 IPv4 设置中选择 “使用以下 DNS 服务器地址”,输入相应的 DNS 服务器地址并保存设置.
pluginManagement {
repositories {
// 阿里云镜像
maven("https://maven.aliyun.com/release/")
// 华为云镜像
maven("https://mirrors.huaweicloud.com/repository/maven/")
// 腾讯云镜像
maven("https://mirrors.cloud.tencent.com/nexus/repository/maven-public/")
maven("https://jitpack.io")
maven("https://maven.aliyun.com/repository/gradle-plugin")
maven("https://maven.aliyun.com/repository/google")
maven("https://maven.aliyun.com/repository/central")
maven("https://maven.aliyun.com/repository/public")
//淘宝镜像源
maven("https://registry.npmmirror.com")
//腾讯云镜像源
maven("https://mirrors.cloud.tencent.com/npm/")
//官方 CNPM 镜像
maven("https://r.cnpmjs.org")
google {
mavenContent {
includeGroupAndSubgroups("androidx")
includeGroupAndSubgroups("com.android")
includeGroupAndSubgroups("com.google")
}
}
mavenCentral()
gradlePluginPortal()
}
}
dependencyResolutionManagement {
repositories {
// 阿里云镜像
maven("https://maven.aliyun.com/release/")
// 华为云镜像
maven("https://mirrors.huaweicloud.com/repository/maven/")
// 腾讯云镜像
maven("https://mirrors.cloud.tencent.com/nexus/repository/maven-public/")
maven("https://jitpack.io")
maven("https://maven.aliyun.com/repository/gradle-plugin")
maven("https://maven.aliyun.com/repository/google")
maven("https://maven.aliyun.com/repository/central")
maven("https://maven.aliyun.com/repository/public")
//淘宝镜像源
maven("https://registry.npmmirror.com")
//腾讯云镜像源
maven("https://mirrors.cloud.tencent.com/npm/")
//官方 CNPM 镜像
maven("https://r.cnpmjs.org")
google {
mavenContent {
includeGroupAndSubgroups("androidx")
includeGroupAndSubgroups("com.android")
includeGroupAndSubgroups("com.google")
}
}
mavenCentral()
}
}
不管是运行Gradle的task哪个任务(kotlin browser->wasmJsBrowserRun)还是运行(other->wasmJsRun),提示的错误,都可以用以上国内镜像源代替:
Could not resolve com.yarnpkg:yarn:1.22.17.
Required by:
project :
> Could not resolve com.yarnpkg:yarn:1.22.17.
> Could not get resource 'https://github.com/yarnpkg/yarn/releases/download/v1.22.17/yarn-v1.22.17.tar.gz'.
> Could not HEAD 'https://github.com/yarnpkg/yarn/releases/download/v1.22.17/yarn-v1.22.17.tar.gz'.
> Got socket exception during request. It might be caused by SSL misconfiguration
> Connect to github.com:443 [github.com/20.205.243.166] failed: Connection timed out: no further information
Connect to https://github.com:443 [github.com/20.205.243.166] failed: Connection timed out: no further information. If you are behind an HTTP proxy, please configure the proxy settings either in IDE or Gradle
4:Android环境编译
Could not find compile target android-34 for modules :composeApp, :shared
点击composeApp\src\androidMain\AndroidManifest.xml
会在右上角显示Install Android plugin 点击后依照提示Next就会自动下载安装,然后重启IDE就可以使用了
SDK location not found. Define a valid SDK location with an ANDROID_HOME environment variable or by setting the sdk.dir path in your project's local properties file at 'D:\pro\ComposeMultiplatform\local.properties'.
找到项目根目录local.properties文件添加本地配置属性,输入你的Android SDK本地路径
org.gradle.java.home=C\:\\Program Files\\Java\\jdk-17
sdk.dir=D\:\\Program Files\\Android\\sdk
Cannot locate tasks that match ':composeApp:compileJava' as task 'compileJava' is ambiguous in project ':composeApp'. Candidates are: 'compileDebugAndroidTestJavaWithJavac', 'compileDebugJavaWithJavac', 'compileDebugUnitTestJavaWithJavac', 'compileReleaseJavaWithJavac', 'compileReleaseUnitTestJavaWithJavac'.
Clear Project 清除IDEA缓存 重启IDEA
打开settings配置Android SDK Manager
5:Android 运行到手机/模拟器
打开Gradle task列表点击android->sourceSets和signingReport
点击Idea的Run 运行栏打开EditConfigurations
Run/Debug configurations选择android ,如下图所示,如果你的本地安装了android adb 现在你就可以在自己android手机上运行compose
6:IOS环境编译 (后续补充)
打开iosApp.xcodeproj 的projec.pb.xpbxproj 在右边会显示Install Multi-OS Engine plugin
点击安装以后 然后重启idea
在Run/Debug configuratios就可以看到 Multi-OS Engine plugin的配置不过博主没有ios和注册ios相关开发账号 (后续补充)