PAYATHON 2026

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 视图查看模块和源码集最可靠。

备注:内容仅供参考。