خانه / مستندات / Jetpack Compose / مقدمه / راه اندازی افزونه Gradle کامپایلر Compose

راه اندازی افزونه Gradle کامپایلر Compose

برای Gradle، از افزونه Compose Compiler Gradle برای راه اندازی و پیکربندی Compose استفاده کنید.

نکته: افزونه Compose Compiler Gradle Plugin فقط از Kotlin نسخه 2.0 به بعد در دسترس است. برای دستورالعمل‌های مهاجرت، بخش «انتقال کامپایلر Jetpack Compose به مخزن Kotlin» را ببینید.

راه اندازی با Gradle Version Catalogs

برای راه اندازی افزونه Compose Compiler Gradle مراحل زیر را انجام دهید:

در فایل libs.versions.toml، هرگونه ارجاع به Compose Compiler را حذف کنید.

در بخش‌های versions و plugins، وابستگی جدید را اضافه کنید:

[versions]
kotlin = "2.3.21"

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

# این خط را اضافه کنید
compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }

در فایل build.gradle.kts ریشه پروژه، مورد زیر را به بخش plugins اضافه کنید:

plugins {
   // پلاگین‌های موجود
   alias(libs.plugins.compose.compiler) apply false
}

در هر ماژولی که از Compose استفاده می‌کند، پلاگین را اعمال کنید:

plugins {
   // پلاگین‌های موجود
   alias(libs.plugins.compose.compiler)
}

اگر پروژه از تنظیمات پیش‌فرض استفاده می‌کرده باشد، اکنون باید بدون مشکل build و compile شود. اگر گزینه‌های سفارشی برای کامپایلر Compose پیکربندی کرده‌اید، بخش بعدی را دنبال کنید.

راه‌اندازی Compose Compiler بدون Gradle Version Catalogs

پلاگین را به فایل‌های build.gradle.kts مربوط به ماژول‌هایی که در آن‌ها از Compose استفاده می‌شود اضافه کنید:

plugins {
    id("org.jetbrains.kotlin.plugin.compose") version "2.3.21" // این نسخه با نسخه Kotlin شما مطابقت دارد
}

Classpath را به فایل build.gradle.kts سطح بالای پروژه اضافه کنید:

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

گزینه‌های پیکربندی با افزونه 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 استفاده کنید:

برای فعال کردن قابلیت‌های Compose در Android Studio، مقدار گزینه compose را داخل Android BuildFeatures برابر true قرار دهید.

تعریف زیر را به فایل build.gradle اپلیکیشن خود اضافه کنید:

android {
    buildFeatures {
        compose true
    }
}

سپس Compose BOM و مجموعه‌ای از وابستگی‌های کتابخانه Compose را اضافه کنید:

dependencies {

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

    // یکی از موارد زیر را انتخاب کنید:

    // Material Design 3
    implementation 'androidx.compose.material3:material3'

    // یا Material Design را نادیده بگیرید و مستقیماً بر اساس کامپوننت‌های پایه بسازید
    implementation 'androidx.compose.foundation:foundation'

    // یا فقط APIهای اصلی سیستم‌های زیربنایی ابزار UI را وارد کنید،
    // مانند ورودی و اندازه‌گیری/Layout
    implementation 'androidx.compose.ui:ui'

    // پشتیبانی از Preview در Android Studio
    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'

    // اختیاری - افزودن ابزارهای اندازه پنجره
    implementation 'androidx.compose.material3.adaptive:adaptive'

    // اختیاری - یکپارچه‌سازی با Activityها
    implementation 'androidx.activity:activity-compose:1.13.0'

    // اختیاری - یکپارچه‌سازی با ViewModelها
    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.10.0'

    // اختیاری - یکپارچه‌سازی با LiveData
    implementation 'androidx.compose.runtime:runtime-livedata'

    // اختیاری - یکپارچه‌سازی با RxJava
    implementation 'androidx.compose.runtime:runtime-rxjava2'
}

این محتوا کاملا رایگان توسط تیم کدلپر ترجمه شده و در اختیار شما کاربران عزیز قرار گرفته است، هر گونه کپی برداری برای مقاصد غیر رایگان و بدون ذکر منبع، مورد پیگیری قانونی قرار میگیرد.

ترجمه شده از منبع: https://developer.android.com/develop/ui/compose/documentation