So sánh Lightbuild với Kotlin DSL

Nếu bạn đã quen với việc định cấu hình bản dựng Android bằng Kotlin DSL, thì trang này sẽ cho bạn biết cách các cấu hình Kotlin DSL phổ biến liên kết với Lightbuild.

Các ví dụ trên trang này sử dụng DSL Kotlin và trình bổ trợ Android cho Gradle (AGP) 9.0 trở lên, bao gồm cả hỗ trợ Kotlin tích hợp sẵn.

Tệp bản dựng

Bảng sau đây cho thấy tệp bản dựng Kotlin DSL tương đương của từng tệp bản dựng Lightbuild:

Cài đặt dự án

Trong Kotlin DSL, tệp settings.gradle.kts xác định tên của dự án, các mô-đun và kho lưu trữ để phân giải các phần phụ thuộc:

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

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

Trong Lightbuild, tệp project.lightbuild.yaml xác định các chế độ cài đặt tương tự:

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

Bảng sau đây so sánh các chế độ cài đặt trên toàn dự án:

Loại mô-đun và trình bổ trợ

Trong Kotlin DSL, bạn chọn loại mô-đun bằng cách áp dụng một trình bổ trợ và áp dụng các trình bổ trợ khác để thêm các tính năng như KSP. Trong Lightbuild, bạn đặt type của mô-đun và Lightbuild sẽ áp dụng các tính năng mà cấu hình của bạn cần:

Cài đặt Android

Trong Kotlin DSL, bạn định cấu hình các chế độ cài đặt Android trong khối android của tệp build.gradle.kts của mô-đun:

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

Trong Lightbuild, bạn định cấu hình các chế độ cài đặt tương tự trong khối android của tệp lightbuild.yaml của mô-đun:

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"

Bảng sau đây so sánh các chế độ cài đặt này:

Phần phụ thuộc

Trong Kotlin DSL, bạn khai báo các phần phụ thuộc trong khối dependencies, sử dụng các cấu hình như implementation:

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

Trong Lightbuild, bạn liệt kê các phần phụ thuộc của mô-đun trong module và các thư viện bên ngoài trong maven:

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

Kotlin DSL sử dụng các cấu hình khác, chẳng hạn như api, compileOnly và runtimeOnly, để kiểm soát cách một mô-đun sử dụng phần phụ thuộc:

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

Trong Lightbuild, bạn thêm chế độ cài đặt compile và runtime vào phần phụ thuộc:

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

Để biết thêm thông tin về các chế độ cài đặt này, hãy xem phần Cài đặt phần phụ thuộc.

Bảng sau đây so sánh các nội dung khai báo phần phụ thuộc phổ biến:

lợi điểm bán hàng chính

Trong Kotlin DSL, bạn áp dụng trình bổ trợ KSP và thêm trình xử lý bằng cấu hình 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")
}

Trong Lightbuild, bạn thêm bộ xử lý vào khối kspProcessors và Lightbuild sẽ tự động áp dụng trình bổ trợ 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

Xét nghiệm

Trong Kotlin DSL, bạn đặt trình chạy kiểm thử đo lường trong defaultConfig và thêm các phần phụ thuộc kiểm thử bằng cấu hình testImplementation và 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")
}

Trong Lightbuild, bạn định cấu hình kiểm thử cục bộ trong tests.test và kiểm thử đo lường trong 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

Lệnh tạo bản dựng

Với Kotlin DSL, bạn có thể tạo và kiểm thử từ dòng lệnh bằng cách chạy các tác vụ Gradle bằng trình bao bọc Gradle. Với Lightbuild, bạn sử dụng Lightbuild CLI.

Để biết thêm thông tin, hãy xem bài viết Xây dựng ứng dụng từ dòng lệnh và Xây dựng dự án Lightbuild từ dòng lệnh.

Khoá phần phụ thuộc

Với Kotlin DSL, khoá phần phụ thuộc là không bắt buộc: bạn bật tính năng này trong tập lệnh bản dựng, sau đó ghi tệp khoá bằng cách chạy bản dựng có cờ --write-locks. Trong Lightbuild, mỗi mô-đun đều có một tệp resolved.deps ghi lại các phần phụ thuộc đã được giải quyết của mô-đun. Lightbuild sẽ tự động tạo tệp này. Giống như với tệp khoá Gradle, hãy kiểm tra các tệp resolved.deps của bạn để quản lý phiên bản.

Để khoá các phần phụ thuộc, chẳng hạn như trong bản dựng CI, hãy thêm cờ --locked-dependencies vào lightbuild resolve hoặc lightbuild test. Với cờ này, lệnh sẽ không thành công nếu tệp resolved.deps không khớp với các phần phụ thuộc của mô-đun, thay vì cập nhật tệp:

lightbuild resolve --locked-dependencies

Tính năng không được hỗ trợ

Lightbuild không hỗ trợ các tính năng Kotlin DSL sau:

• Danh mục phiên bản và trình bổ trợ quy ước
• Trình bổ trợ tuỳ chỉnh
• Phiên bản sản phẩm. Thay vào đó, hãy tạo một mô-đun ứng dụng riêng cho từng phiên bản của ứng dụng. Để biết thêm thông tin, hãy xem phần Nhiều mô-đun ứng dụng.
• Mô-đun Kotlin Multiplatform (KMP)
• Phân giải phần phụ thuộc thông qua máy chủ proxy

Ngoài ra, một dự án không thể kết hợp các mô-đun Kotlin DSL và Lightbuild. Để biết các vấn đề đã biết, hãy xem ghi chú phát hành của Lightbuild.