KMP androidApp 模块无法访问 Compose 依赖
结论
在 androidApp 里看不到 Compose 依赖,多数情况下并不代表项目损坏。KMP 模板常把 Compose 相关插件和依赖配在共享模块里(常见是 commonMain 所在模块),androidApp 只负责 Android 入口。既然 commonMain 的 App.kt 可以使用 composables,建议把共享 Compose UI 放在 commonMain,再由 androidApp 的 MainActivity 调用 App()。如果确实需要 Android 专用的 Compose UI,再到 androidApp/build.gradle.kts 中单独启用 Compose 并添加依赖。
原因
commonMain 能访问 composables,说明 Compose 依赖已经加在共享模块的源码集里,而 androidApp 的源码集不会自动继承这些依赖。Android Studio 里文件夹显示发生变化,只是 Android 视图和 Project 视图的区别,并不表示模块依赖被改了。切到 Project 视图就能看到真实路径,例如 androidApp/build.gradle.kts 和共享模块下的 commonMain。
推荐做法:UI 放 commonMain,androidApp 调用
共享模块的 App.kt:
import androidx.compose.foundation.layout.Column
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
@Composable
fun App() {
Column {
Text("Hello KMP")
}
}
androidApp 的 MainActivity:
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import com.example.shared.App // 替换为实际包名
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
App()
}
}
}
如果 androidApp 尚未依赖共享模块,需要在 androidApp/build.gradle.kts 的 dependencies 中添加项目依赖,模块名按实际项目替换:
dependencies {
implementation(project(":shared")) // 可能是 :composeApp 等
}
setContent 来自 androidx.activity:activity-compose。如果 androidApp 里没有这个依赖,需要先加上;模板通常自带,但不同版本可能不一样。
如果确实要在 androidApp 写 Jetpack Compose
需要在 androidApp/build.gradle.kts 中启用 Compose 并添加 AndroidX Compose 依赖。下面只展示关键片段,版本和现有配置按项目实际值保留:
plugins {
id("com.android.application")
id("org.jetbrains.kotlin.android")
id("org.jetbrains.kotlin.plugin.compose") // Kotlin 2.0+;旧版本改用 composeOptions
}
android {
// ... 保留模板已有配置
buildFeatures {
compose = true
}
}
dependencies {
implementation(platform("androidx.compose:compose-bom:<BOM_VERSION>"))
implementation("androidx.compose.ui:ui")
implementation("androidx.compose.ui:ui-tooling-preview")
implementation("androidx.compose.material3:material3")
implementation("androidx.activity:activity-compose")
debugImplementation("androidx.compose.ui:ui-tooling")
}
如果项目使用 Kotlin 1.9 或更早版本,通常需要在 android 块中配置:
composeOptions {
kotlinCompilerExtensionVersion = "<COMPOSE_COMPILER_VERSION>"
}
不要在 Kotlin 2.0+ 项目中同时套用旧版 composeOptions 和新版 Compose 编译器插件,按项目实际 Kotlin 版本选一种。
注意事项
- 如果
commonMain已经在用 Compose Multiplatform,androidApp通常只需调用共享的App()。不要再额外加一套androidx.compose.material3依赖,否则容易出现依赖和主题重复。 - 模块名不要照抄,
shared、composeApp等都要以项目实际配置为准。 - 改完后执行 Gradle Sync。如果补全仍然不正常,检查
androidApp的dependencies是否在对应的 source set 中生效。 - 文件夹的显示方式不影响代码位置,用 Project 视图查看模块和源码集最可靠。
备注:内容仅供参考。
