إعداد المكوّن الإضافي Compose Compiler Gradle

بالنسبة إلى Gradle، استخدِم المكوّن الإضافي Compose Compiler Gradle لإعداد Compose وضبطه.

ملاحظة: لا يتوفّر المكوّن الإضافي Compose Compiler Gradle إلا في Kotlin 2.0 والإصدارات الأحدث. وللحصول على تعليمات النقل، يُرجى الاطّلاع على "نقل أداة تجميع Jetpack Compose إلى مستودع Kotlin".

الإعداد باستخدام كتالوجات إصدارات Gradle

إعداد المكوّن الإضافي Compose Compiler Gradle:

1. في ملف libs.versions.toml، أزِل أي إشارة إلى Compose Compiler.
2. في القسمَين versions وplugins، أضِف الاعتمادية الجديدة:

[versions]
kotlin = "2.3.10"

[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. في ملف build.gradle.kts الجذري للمشروع، أضِف ما يلي إلى قسم plugins.

plugins {
   // Existing plugins
   alias(libs.plugins.compose.compiler) apply false
}

1. في كل وحدة تستخدم Compose، طبِّق المكوّن الإضافي:

plugins {
   // Existing plugins
   alias(libs.plugins.compose.compiler)
}

من المفترض أن يتم الآن إنشاء المشروع وتجميعه إذا كان يستخدم الإعداد التلقائي. إذا تم ضبط خيارات مخصّصة في برنامج التجميع Compose، يُرجى اتّباع الخطوات الواردة في القسم التالي.

إعداد Compose Compiler بدون كتالوجات إصدارات Gradle

أضِف المكوّن الإضافي إلى ملفات build.gradle.kts المرتبطة بالوحدات التي يتم فيها استخدام Compose:

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

أضِف مسار الفئة إلى ملف build.gradle.kts الخاص بمشروعك على المستوى الأعلى:

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

خيارات الإعداد باستخدام المكوّن الإضافي 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")
}

للاطّلاع على القائمة الكاملة بالخيارات المتاحة، يُرجى الرجوع إلى المستندات.

إعداد تبعيات Compose

استخدِم دائمًا أحدث إصدار من Compose BOM: 2026.03.00.

اضبط العلامة compose على true داخل ملف BuildFeatures في Android لتفعيل وظائف Compose في "استوديو Android".

أضِف التعريف التالي إلى ملف build.gradle في تطبيقك:

Groovy

android {
    buildFeatures {
        compose true
    }
}

Kotlin

android {
    buildFeatures {
        compose = true
    }
}

أضِف حزمة إدارة مواد Compose وقائمة الموارد التابعة لمكتبة Compose:

Groovy

dependencies {

    def composeBom = platform('androidx.compose:compose-bom:2026.03.00')
    implementation composeBom
    androidTestImplementation composeBom

    // Choose one of the following:
    // Material Design 3
    implementation 'androidx.compose.material3:material3'
    // or skip Material Design and build directly on top of foundational components
    implementation 'androidx.compose.foundation:foundation'
    // or only import the main APIs for the underlying toolkit systems,
    // such as input and measurement/layout
    implementation 'androidx.compose.ui:ui'

    // Android Studio Preview support
    implementation 'androidx.compose.ui:ui-tooling-preview'
    debugImplementation 'androidx.compose.ui:ui-tooling'

    // UI Tests
    androidTestImplementation 'androidx.compose.ui:ui-test-junit4'
    debugImplementation 'androidx.compose.ui:ui-test-manifest'

    // Optional - Add window size utils
    implementation 'androidx.compose.material3.adaptive:adaptive'

    // Optional - Integration with activities
    implementation 'androidx.activity:activity-compose:1.13.0'
    // Optional - Integration with ViewModels
    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.10.0'
    // Optional - Integration with LiveData
    implementation 'androidx.compose.runtime:runtime-livedata'
    // Optional - Integration with RxJava
    implementation 'androidx.compose.runtime:runtime-rxjava2'

}

Kotlin

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2026.03.00")
    implementation(composeBom)
    androidTestImplementation(composeBom)

    // Choose one of the following:
    // Material Design 3
    implementation("androidx.compose.material3:material3")
    // or skip Material Design and build directly on top of foundational components
    implementation("androidx.compose.foundation:foundation")
    // or only import the main APIs for the underlying toolkit systems,
    // such as input and measurement/layout
    implementation("androidx.compose.ui:ui")

    // Android Studio Preview support
    implementation("androidx.compose.ui:ui-tooling-preview")
    debugImplementation("androidx.compose.ui:ui-tooling")

    // UI Tests
    androidTestImplementation("androidx.compose.ui:ui-test-junit4")
    debugImplementation("androidx.compose.ui:ui-test-manifest")

    // Optional - Add window size utils
    implementation("androidx.compose.material3.adaptive:adaptive")

    // Optional - Integration with activities
    implementation("androidx.activity:activity-compose:1.13.0")
    // Optional - Integration with ViewModels
    implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.10.0")
    // Optional - Integration with LiveData
    implementation("androidx.compose.runtime:runtime-livedata")
    // Optional - Integration with RxJava
    implementation("androidx.compose.runtime:runtime-rxjava2")

}

ملاحظة: يتم شحن Jetpack Compose باستخدام قائمة مواد (BOM) للحفاظ على مزامنة إصدارات جميع مجموعات المكتبات. يمكنك الاطّلاع على مزيد من المعلومات في صفحة "قائمة المواد".