הפלאגין של Compose Compiler Gradle
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משתמשי Gradle יכולים להשתמש בפלאגין Compose Compiler Gradle כדי להקל על ההגדרה וההתאמה האישית של Compose.
הגדרה באמצעות קטלוגים של גרסאות Gradle
בהוראות הבאות מוסבר איך מגדירים את הפלאגין של Compose Compiler ל-Gradle:
- בקובץ
libs.versions.toml
, מסירים כל הפניה למהדר של Compose.
- בקטע plugins, מוסיפים את יחסי התלות החדשים הבאים:
[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" }
- בקובץ
build.gradle.kts
ברמה הבסיסית של הפרויקט, מוסיפים את הקטע הבא לקטע plugins:
plugins {
// Existing plugins
alias(libs.plugins.compose.compiler) apply false
}
- בכל מודול שבו נעשה שימוש ב-Compose, מחילים את הפלאגין:
plugins {
// Existing plugins
alias(libs.plugins.compose.compiler)
}
אם אתם משתמשים בהגדרת ברירת המחדל, האפליקציה אמורה להיבנות ולעבור הידור. אם הגדרתם אפשרויות בהתאמה אישית במהדר של Compose, תוכלו לעיין בקטע הבא.
הגדרה ללא קטלוגים של גרסאות Gradle
כדי להגדיר את הפלאגין Compose Compiler Gradle בלי קטלוגים של גרסאות, מוסיפים את הפלאגין הבא לקובצי build.gradle.kts
שמשויכים למודולים שבהם אתם משתמשים ב-Compose:
plugins {
id("org.jetbrains.kotlin.plugin.compose") version "2.0.0" // this version matches your Kotlin version
}
אפשרויות הגדרה באמצעות הפלאגין Compose Compiler Gradle
כדי להגדיר את המהדר של Compose באמצעות הפלאגין של Gradle, מוסיפים את הבלוק composeCompiler
לקובץ build.gradle.kts
של המודול ברמה העליונה.
android { … }
composeCompiler {
reportsDestination = layout.buildDirectory.dir("compose_compiler")
stabilityConfigurationFile = rootProject.layout.projectDirectory.file("stability_config.conf")
}
הרשימה המלאה של האפשרויות הזמינות מופיעה במסמכי העזרה.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Compose Compiler Gradle plugin\n\nFor Gradle users, you can use the Compose Compiler Gradle plugin to make setting\nup and configuring Compose easier.\n| **Note:** The Compose Compiler Gradle Plugin is only available from Kotlin 2.0+. For migration instructions, see [\"Jetpack Compose compiler moving to the Kotlin\n| repository\"](https://android-developers.googleblog.com/2024/04/jetpack-compose-compiler-moving-to-kotlin-repository.html). For an example migration, see the [Compose Samples\n| PR](https://github.com/android/compose-samples/pull/1354) in the Compose samples.\n\nSet up with Gradle version catalogs\n-----------------------------------\n\nThe following instructions outline how you can set up the Compose Compiler\nGradle plugin:\n\n1. In your `libs.versions.toml` file, remove any reference to the Compose compiler\n2. In the plugins section, add the following new dependency\n\n [versions]\n kotlin = \"2.0.0\"\n\n [plugins]\n org-jetbrains-kotlin-android = { id = \"org.jetbrains.kotlin.android\", version.ref = \"kotlin\" }\n\n // Add this line\n compose-compiler = { id = \"org.jetbrains.kotlin.plugin.compose\", version.ref = \"kotlin\" }\n\n1. In your projects root `build.gradle.kts` file, add the following to the plugins section:\n\n plugins {\n // Existing plugins\n alias(libs.plugins.compose.compiler) apply false\n }\n\n1. In each module that uses Compose, apply the plugin:\n\n plugins {\n // Existing plugins\n alias(libs.plugins.compose.compiler)\n }\n\nYour app should now build and compile if you are using the default set up. If\nyou had configured custom options on the Compose compiler, see the following\nsection.\n\nSet up without Gradle version catalogs\n--------------------------------------\n\nTo set up the Compose Compiler Gradle plugin without version catalogs, add the\nfollowing plugin to `build.gradle.kts` files associated with modules you use\nCompose: \n\n plugins {\n id(\"org.jetbrains.kotlin.plugin.compose\") version \"2.0.0\" // this version matches your Kotlin version\n }\n\nConfiguration options with the Compose Compiler Gradle Plugin\n-------------------------------------------------------------\n\nTo configure the Compose compiler using the Gradle plugin, add the\n`composeCompiler` block to the module's `build.gradle.kts` file at the top\nlevel. \n\n android { ... }\n\n composeCompiler {\n reportsDestination = layout.buildDirectory.dir(\"compose_compiler\")\n stabilityConfigurationFile = rootProject.layout.projectDirectory.file(\"stability_config.conf\")\n }\n\nFor the full list of available options, see the [documentation](https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-compiler.html#compose-compiler-options-dsl)."]]