Trình bổ trợ Gradle của Trình biên dịch Compose

Đối với người dùng Gradle, bạn có thể sử dụng trình bổ trợ Compose Compiler Gradle để thiết lập và định cấu hình Compose dễ dàng hơn.

Thiết lập bằng danh mục phiên bản Gradle

Các hướng dẫn sau đây trình bày cách thiết lập trình bổ trợ Gradle Compose Compiler:

  1. Trong tệp libs.versions.toml, hãy xoá mọi thông tin tham chiếu đến trình biên dịch Compose
  2. Trong mục trình bổ trợ, hãy thêm phần phụ thuộc mới sau đây
[versions]
kotlin = "2.0.0"

[plugins]
org-jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }

// Add this line
compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
  1. Trong tệp build.gradle.kts gốc của dự án, hãy thêm nội dung sau vào phần plugin:
plugins {
   // Existing plugins
   alias(libs.plugins.compose.compiler) apply false
}
  1. Trong mỗi mô-đun sử dụng Compose, hãy áp dụng trình bổ trợ:
plugins {
   // Existing plugins
   alias(libs.plugins.compose.compiler)
}

Ứng dụng của bạn hiện sẽ tạo và biên dịch nếu bạn đang sử dụng chế độ thiết lập mặc định. Nếu bạn đã định cấu hình các lựa chọn tuỳ chỉnh trên trình biên dịch Compose, hãy xem phần sau.

Thiết lập mà không cần danh mục phiên bản Gradle

Để thiết lập trình bổ trợ Compose Compiler Gradle mà không cần danh mục phiên bản, hãy thêm trình bổ trợ sau vào các tệp build.gradle.kts được liên kết với các mô-đun mà bạn sử dụng Compose:

plugins {
    id("org.jetbrains.kotlin.plugin.compose") version "2.0.0" // this version matches your Kotlin version
}

Bạn cũng có thể cần thêm đường dẫn lớp này vào tệp build.gradle.kts dự án cấp cao nhất:

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin.plugin.compose:org.jetbrains.kotlin.plugin.compose.gradle.plugin:2.0.0")
    }
}

Các lựa chọn cấu hình với trình bổ trợ Compose Compiler Gradle

Để định cấu hình trình biên dịch Compose bằng trình bổ trợ Gradle, hãy thêm khối composeCompiler vào tệp build.gradle.kts của mô-đun ở cấp cao nhất.

android { … }

composeCompiler {
    reportsDestination = layout.buildDirectory.dir("compose_compiler")
    stabilityConfigurationFile = rootProject.layout.projectDirectory.file("stability_config.conf")
}

Để xem danh sách đầy đủ các lựa chọn có sẵn, hãy xem tài liệu.