إنشاء مكوّن Gradle الإضافي لأداة التحويل البرمجي

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

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

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

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

[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. في ملف build.gradle.kts الجذر الخاص بمشاريعك، أضِف ما يلي إلى قسم المكوّنات الإضافية:

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

1. في كل وحدة تستخدم 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
}

قد تحتاج أيضًا إلى إضافة مسار الفئة هذا إلى ملف build.gradle.kts الخاص بمشروعك على المستوى الأعلى:

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

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

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