Android项目如何引入Compose
现在还有多少项目没用上Kotlin,Google就在三年前又就放出了Compose,一种全新的声明式UI开发框架。具体学习可以参考官方Compose Demo。
在 Android 项目中引入 Jetpack Compose 很简单,首先确保安装了支持 Jetpack Compose 的最新版本的 Android Studio,配置具体步骤如下:
1. 创建新的 Compose 项目
创建一个新的支持 Compose 的项目,可以按照以下步骤操作,现在新项目默认都是支持Compose的。
①打开 Android Studio,点击 Start a new Android Studio project 或 File > New > New Project。
②在 Select a Project Template 窗口中,选择 Empty Compose Activity。
③在 Configure your project 窗口中,设置项目名称、包名和保存位置。注意,语言选项只能选择 Kotlin。
④设置 Minimum API level 为 21 或更高。
⑤点击 Finish,项目将自动配置好 Compose。
2. 在现有项目中引入 Compose
如果要在现有项目中引入 Compose,需要进行以下配置:
①启用 Compose 功能:在项目的 build.gradle (Module: app) 文件中,添加以下配置:
android {
buildFeatures {
compose = true
}
} ②添加 Compose 依赖:在 build.gradle 文件中,添加以下依赖:
dependencies {
def composeBom = platform('androidx.compose:compose-bom:2025.02.00')
implementation composeBom
androidTestImplementation composeBom
implementation 'androidx.compose.material3:material3'
implementation 'androidx.compose.ui:ui'
implementation 'androidx.compose.ui:ui-tooling-preview'
debugImplementation 'androidx.compose.ui:ui-tooling'
androidTestImplementation 'androidx.compose.ui:ui-test-junit4'
debugImplementation 'androidx.compose.ui:ui-test-manifest'
} ③启用 Kotlin 编译器插件:确保 Kotlin 编译器插件已启用:
android {
kotlinOptions {
jvmTarget = "1.8"
useIR = true
}
} 在老项目中可以借助androidx.compose.ui.platform.ComposeView桥接使用Compose。
<androidx.compose.ui.platform.ComposeView xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/root"
android:layout_width="match_parent"
android:layout_height="match_parent">
...
</androidx.compose.ui.platform.ComposeView>
3. 验证和运行
①打开Activity入口,确保项目中包含 Compose 的入口点。
②使用 Android Studio 的 Live Preview 功能查看 Compose UI 的实时预览。
③连接设备或启动模拟器,点击 Run 按钮运行应用。
4. 常见问题
①如果 Android Studio 未检测到 Jetpack Compose,请确保安装了最新版本的 Android Studio 和 Kotlin。
②如果 Gradle 同步失败,请更新依赖项并从 File > Sync Project with Gradle Files同步。
按照以上步骤,就可以在 Android 项目中成功引入 Jetpack Compose。接下来就是用Compose开发界面。