Windows10下Android Studio中Task 'wrapper' not found错误修复及咨询

我正在学习Mouaad Aallam开发的OpenAI开源库openai-kotlin，其原生示例项目在Windows10系统的Android Studio中打开时，出现错误「Task 'wrapper' not found in project ':sample:native'」。错误日志及项目build.gradle.kts配置如下，现咨询两个问题：

1. 如何修复该错误？
2. 是否存在基于openai-kotlin的其他完整Android Studio演示项目？

错误日志 #

Starting Gradle Daemon...
Gradle Daemon started in 1 s 404 ms
Type-safe project accessors is an incubating feature.
Project accessors enabled, but root project name not explicitly set for 'build-support'. Checking out the project in different folders will impact the generated code and implicitly the buildscript classpath, breaking caching.
> Task :build-support:compileKotlin UP-TO-DATE
> Task :build-support:compileJava NO-SOURCE
> Task :build-support:pluginDescriptors UP-TO-DATE
> Task :build-support:processResources UP-TO-DATE
> Task :build-support:classes UP-TO-DATE
> Task :build-support:jar UP-TO-DATE
> Task :build-support:inspectClassesForKotlinIC UP-TO-DATE

FAILURE: Build failed with an exception.

* What went wrong:
Task 'wrapper' not found in project ':sample:native'.

项目build.gradle.kts配置 #

plugins {
    kotlin("multiplatform")
}

kotlin {
    val hostOs = System.getProperty("os.name")
    val isMingwX64 = hostOs.startsWith("Windows")
    val nativeTarget = when {
        hostOs == "Mac OS X" -> macosX64("native")
        hostOs == "Linux" -> linuxX64("native")
        isMingwX64 -> mingwX64("native")
        else -> throw GradleException("Host OS is not supported in Kotlin/Native.")
    }
    nativeTarget.apply {
        binaries {
            executable {
                entryPoint = "main"
            }
        }
    }
    sourceSets {
        val nativeMain by getting {
            dependencies {
                //implementation("com.aallam.openai:openai-client:<version>")
                implementation(projects.openaiClient)
                implementation(libs.ktor.client.curl)
            }
        }
    }
}

问题解答 #

1. 修复「Task 'wrapper' not found」错误 #

这个错误是因为直接打开了:sample:native子模块，而Gradle Wrapper的配置仅存在于项目根目录，子模块没有单独的wrapper任务。有两种解决方式：

• 优先方案：打开项目根目录：关闭当前子模块，重新在Android Studio中打开openai-kotlin的根目录（包含settings.gradle.kts和根级build.gradle.kts的文件夹），这样Gradle就能识别到根项目的wrapper配置，正常执行构建。
• 备选方案：给子模块添加wrapper任务：如果必须单独打开子模块，在:sample:native的build.gradle.kts中添加Gradle Wrapper插件配置：

  plugins {
      kotlin("multiplatform")
      // 添加以下插件配置
      `gradle-wrapper`
  }
  

  之后执行./gradlew wrapper命令生成wrapper文件，但这种方式不符合多模块项目的规范管理逻辑，仅作临时应急使用。

2. 其他Android Studio演示项目 #

官方仓库目前没有专门的Android演示模块，但可以通过两种方式获取相关示例：

• 自行搭建Android模块：在openai-kotlin根项目中新增Android模块，依赖com.aallam.openai:openai-client，替换原生示例中的curl客户端为Ktor Android客户端，结合官方文档的初始化和API调用示例即可完成基础实现。
• 社区共享项目：在代码托管平台搜索基于openai-kotlin的Android项目，部分开发者会分享自己的实现，但注意选择维护状态良好的项目。

内容的提问来源于stack exchange，提问作者HelloCW