مقارنة Lightbuild مع Kotlin DSL

إذا كنت على دراية بإعداد إصدارات Android باستخدام Kotlin DSL، توضّح هذه الصفحة كيفية ربط إعدادات Kotlin DSL الشائعة بـ Lightbuild.

تستخدم الأمثلة الواردة في هذه الصفحة لغة Kotlin DSL والإصدار 9.0 أو إصدار أحدث من المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP)، والذي يتضمّن دعمًا مدمجًا للغة Kotlin.

ملفات الإصدار

يوضّح الجدول التالي ملفات Lightbuild المقابلة لكل ملف إصدار Kotlin DSL:

إعدادات المشروع

في Kotlin DSL، يحدّد ملف settings.gradle.kts اسم المشروع ووحداته والمستودعات التي يتم حلّ التبعيات منها:

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}

rootProject.name = "MyApp"
include(":app")
include(":app-core")

في Lightbuild، يحدّد ملف project.lightbuild.yaml الإعدادات نفسها:

project:
  name: MyApp
modules:
  - app
  - app-core
repositories:
  - google
  - mavenCentral

يقارن الجدول التالي الإعدادات على مستوى المشروع:

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

في Kotlin DSL، يمكنك اختيار نوع الوحدة من خلال تطبيق مكوّن إضافي، وتطبيق مكوّنات إضافية أخرى لإضافة ميزات مثل KSP. في Lightbuild، يمكنك ضبط type للوحدة، ويطبّق Lightbuild الميزات التي يتطلّبها الإعداد:

إعدادات Android

في Kotlin DSL، يمكنك ضبط إعدادات Android في مجموعة android ضمن ملف build.gradle.kts الخاص بالوحدة:

plugins {
    id("com.android.application")
}

android {
    namespace = "com.example.myapp.app"
    compileSdk = 36

    defaultConfig {
        applicationId = "com.example.myapp"
        minSdk = 24
        targetSdk = 36
        versionCode = 1
        versionName = "1.0"
    }
}

في Lightbuild، يمكنك ضبط الإعدادات نفسها في مجموعة android ضمن ملف lightbuild.yaml الخاص بالوحدة:

platform: android
type: application
android:
  namespace: com.example.myapp.app
  compileSdk:
    version:
      release:
        apiLevel: 36
  minSdk:
    version:
      release:
        apiLevel: 24
  targetSdk:
    version:
      release:
        apiLevel: 36
  applicationId: com.example.myapp
  versionCode: 1
  versionName: "1.0"

يقارن الجدول التالي بين هذه الإعدادات:

الطلبات التابعة

في Kotlin DSL، يمكنك الإفصاح عن التبعيات في مجموعة dependencies، باستخدام إعدادات مثل implementation:

dependencies {
    implementation(project(":app-core"))
    implementation("androidx.core:core-ktx:1.18.0")
}

في Lightbuild، يمكنك إدراج تبعيات الوحدات ضمن module، والمكتبات الخارجية ضمن maven:

android:
  dependencies:
    module:
      - //app-core
    maven:
      - androidx.core:core-ktx:1.18.0

تستخدم Kotlin DSL إعدادات أخرى، مثل api وcompileOnly وruntimeOnly، للتحكّم في كيفية استخدام الوحدة لتبعية معيّنة:

dependencies {
    api(project(":data"))
    compileOnly("androidx.annotation:annotation:1.9.1")
}

في Lightbuild، يمكنك إضافة إعدادات compile وruntime إلى التبعية بدلاً من ذلك:

android:
  dependencies:
    module:
      - //data:
          compile: public
    maven:
      - androidx.annotation:annotation:1.9.1:
          runtime: off

لمزيد من المعلومات حول هذه الإعدادات، يُرجى الاطّلاع على إعدادات التبعية.

يقارن الجدول التالي بين تعريفات التبعيات الشائعة:

عامل ترويجي رئيسي (KSP)

في Kotlin DSL، يمكنك تطبيق المكوّن الإضافي KSP وإضافة معالِجات باستخدام الإعدادات ksp:

plugins {
    id("com.android.library")
    id("com.google.devtools.ksp")
}

dependencies {
    implementation("com.squareup.moshi:moshi:1.15.2")
    implementation("com.squareup.moshi:moshi-kotlin:1.15.2")
    ksp("com.squareup.moshi:moshi-kotlin-codegen:1.15.2")
}

في Lightbuild، يمكنك إضافة معالجات إلى الحزمة kspProcessors، ويطبّق Lightbuild المكوّن الإضافي KSP تلقائيًا:

type: library
android:
  dependencies:
    maven:
      - com.squareup.moshi:moshi:1.15.2
      - com.squareup.moshi:moshi-kotlin:1.15.2
  kspProcessors:
    maven:
      - com.squareup.moshi:moshi-kotlin-codegen:1.15.2

الاختبارات

في Kotlin DSL، يمكنك ضبط مشغّل اختبار قياس حالة التطبيق في defaultConfig، وإضافة تبعيات الاختبار باستخدام إعدادات testImplementation وandroidTestImplementation:

android {
    defaultConfig {
        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }
}

dependencies {
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.3.0")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.7.0")
}

في Lightbuild، يمكنك ضبط الاختبارات المحلية في tests.test واختبارات لقياس حالة التطبيق في tests.androidTest:

android:
  tests:
    test:
      dependencies:
        maven:
          - junit:junit:4.13.2
    androidTest:
      runner: androidx.test.runner.AndroidJUnitRunner
      dependencies:
        maven:
          - androidx.test.ext:junit:1.3.0
          - androidx.test.espresso:espresso-core:3.7.0

أوامر الإنشاء

باستخدام Kotlin DSL، يمكنك إنشاء الإصدارات واختبارها من سطر الأوامر من خلال تشغيل مهام Gradle باستخدام أداة Gradle Wrapper. باستخدام Lightbuild، يمكنك استخدام Lightbuild CLI.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي إنشاء تطبيقك من سطر الأوامر وإنشاء مشاريع Lightbuild من سطر الأوامر.

قفل التبعيات

باستخدام Kotlin DSL، يكون قفل التبعيات اختياريًا: يمكنك تفعيله في نصوص الإصدار البرمجية، ثم كتابة ملفات القفل عن طريق تشغيل إصدار باستخدام العلامة --write-locks. في Lightbuild، تحتوي كل وحدة على ملف resolved.deps يسجّل التبعيات التي تم حلّها للوحدة، والتي ينشئها Lightbuild تلقائيًا. كما هو الحال مع ملفات قفل Gradle، يمكنك تسجيل ملفات resolved.deps في نظام التحكّم في الإصدارات.

لقفل التبعيات، على سبيل المثال في إصدار CI، أضِف العلامة --locked-dependencies إلى lightbuild resolve أو lightbuild test. باستخدام هذه العلامة، يتعذّر تنفيذ الأمر إذا لم يتطابق ملف resolved.deps مع تبعيات الوحدة، بدلاً من تعديل الملف:

lightbuild resolve --locked-dependencies

الميزات غير المتوافقة

لا تتيح أداة Lightbuild استخدام ميزات Kotlin DSL التالية:

• كتالوجات الإصدارات والمكوّنات الإضافية للاتفاقيات
• المكوّنات الإضافية المخصّصة
• نكهات المنتج بدلاً من ذلك، يمكنك إنشاء وحدة تطبيق منفصلة لكل إصدار من تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على وحدات التطبيقات المتعددة.
• وحدات Kotlin Multiplatform (KMP)
• حلّ التبعيات من خلال خادم وكيل

بالإضافة إلى ذلك، لا يمكن أن يجمع المشروع بين وحدات Kotlin DSL وLightbuild. للاطّلاع على المشاكل المعروفة، يُرجى مراجعة ملاحظات إصدار Lightbuild.