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

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

ملاحظة: لا يتوفّر المكوّن الإضافي Compose Compiler Gradle Plugin إلا من الإصدار 2.0 والإصدارات الأحدث من لغة البرمجة Kotlin. وللحصول على تعليمات حول نقل البيانات، يمكنك الاطّلاع على "نقل المحول البرمجي لـ Jetpack Compose إلى مستودع Kotlin". للاطّلاع على مثال لعملية نقل البيانات، راجِع PR إنشاء عيّنات في نماذج Compose

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

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

1. في ملف libs.versions.toml، عليك إزالة أي إشارة إلى أداة التحويل البرمجي في ComposeAllowed
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 المرتبطة بالوحدات التي تستخدمها إنشاء:

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 {
    enableStrongSkippingMode = true

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

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