Membandingkan Lightbuild dengan DSL Kotlin

Jika Anda sudah memahami cara mengonfigurasi build Android dengan Kotlin DSL, halaman ini menunjukkan cara konfigurasi Kotlin DSL umum dipetakan ke Lightbuild.

Contoh di halaman ini menggunakan DSL Kotlin dan plugin Android Gradle (AGP) 9.0 atau yang lebih tinggi, yang menyertakan dukungan Kotlin bawaan.

File build

Tabel berikut menunjukkan file build Kotlin DSL yang setara dengan Lightbuild:

Setelan project

Dalam DSL Kotlin, file settings.gradle.kts menentukan nama project, modulnya, dan repositori untuk me-resolve dependensi:

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

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

Di Lightbuild, file project.lightbuild.yaml menentukan setelan yang sama:

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

Tabel berikut membandingkan setelan di seluruh project:

Jenis modul dan plugin

Di DSL Kotlin, Anda memilih jenis modul dengan menerapkan plugin, dan Anda menerapkan plugin lain untuk menambahkan fitur seperti KSP. Di Lightbuild, Anda menetapkan type modul, dan Lightbuild akan menerapkan fitur yang diperlukan konfigurasi Anda:

Setelan Android

Di DSL Kotlin, Anda mengonfigurasi setelan Android di blok android pada file build.gradle.kts modul:

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"
    }
}

Di Lightbuild, Anda mengonfigurasi setelan yang sama di blok android pada file lightbuild.yaml modul:

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"

Tabel berikut membandingkan setelan ini:

Dependensi

Di DSL Kotlin, Anda mendeklarasikan dependensi dalam blok dependencies, menggunakan konfigurasi seperti implementation:

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

Di Lightbuild, Anda mencantumkan dependensi modul di bagian module, dan library eksternal di bagian maven:

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

DSL Kotlin menggunakan konfigurasi lain, seperti api, compileOnly, dan runtimeOnly, untuk mengontrol cara modul menggunakan dependensi:

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

Di Lightbuild, Anda menambahkan setelan compile dan runtime ke dependensi:

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

Untuk mengetahui informasi selengkapnya tentang setelan ini, lihat Setelan dependensi.

Tabel berikut membandingkan deklarasi dependensi umum:

nilai jual utama

Di DSL Kotlin, Anda menerapkan plugin KSP dan menambahkan pemroses dengan konfigurasi 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")
}

Di Lightbuild, Anda menambahkan pemroses ke blok kspProcessors, dan Lightbuild akan menerapkan plugin KSP secara otomatis:

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

Pengujian

Di Kotlin DSL, Anda menetapkan runner uji instrumentasi di defaultConfig, dan menambahkan dependensi pengujian dengan konfigurasi testImplementation dan 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")
}

Di Lightbuild, Anda mengonfigurasi pengujian lokal di tests.test dan uji instrumentasi di 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

Perintah build

Dengan Kotlin DSL, Anda mem-build dan menguji dari command line dengan menjalankan tugas Gradle menggunakan wrapper Gradle. Dengan Lightbuild, Anda menggunakan Lightbuild CLI.

Untuk mengetahui informasi selengkapnya, lihat Mem-build aplikasi dari command line dan Mem-build project Lightbuild dari command line.

Penguncian dependensi

Dengan DSL Kotlin, penguncian dependensi bersifat opsional: Anda mengaktifkannya di skrip build, lalu menulis file kunci dengan menjalankan build dengan flag --write-locks. Di Lightbuild, setiap modul memiliki file resolved.deps yang mencatat dependensi modul yang telah diselesaikan, yang dibuat secara otomatis oleh Lightbuild. Seperti file kunci Gradle, periksa file resolved.deps Anda ke kontrol versi.

Untuk mengunci dependensi, misalnya dalam build CI, tambahkan flag --locked-dependencies ke lightbuild resolve atau lightbuild test. Dengan flag ini, perintah akan gagal jika file resolved.deps tidak cocok dengan dependensi modul, bukan mengupdate file:

lightbuild resolve --locked-dependencies

Fitur yang tidak didukung

Lightbuild tidak mendukung fitur DSL Kotlin berikut:

• Katalog versi dan plugin konvensi
• Plugin kustom
• Ragam produk. Sebagai gantinya, buat modul aplikasi terpisah untuk setiap versi aplikasi Anda. Untuk informasi selengkapnya, lihat Beberapa modul aplikasi.
• Modul Kotlin Multiplatform (KMP)
• Resolusi dependensi melalui server proxy

Selain itu, project tidak dapat menggabungkan modul DSL Kotlin dan Lightbuild. Untuk mengetahui masalah umum, lihat catatan rilis Lightbuild.