Android项目如何引入Compose

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开发界面。