Membangun project Lightbuild dari command line

Lightbuild CLI adalah alat command line resmi untuk Lightbuild. Gunakan perintah lightbuild untuk mem-build dan menguji project Anda, menemukan target build-nya, dan menyelesaikan dependensinya. Agen AI Anda dapat menjalankan perintah yang sama. Project yang Anda buat dari template Lightbuild menyertakan file AGENTS.md yang memberi tahu agen AI cara bekerja dengan Lightbuild dan Lightbuild CLI.

Untuk mengetahui informasi selengkapnya tentang perintah dan opsi Lightbuild CLI, lihat referensi Lightbuild CLI.

Menginstal Lightbuild CLI

Lightbuild CLI didistribusikan sebagai paket Android SDK yang Anda instal dengan Android CLI. Anda dapat menginstal dan menyiapkannya dengan satu perintah, atau menginstalnya secara manual.

Menginstal dan menyiapkan dalam satu langkah

Untuk menginstal Lightbuild CLI, jalankan perintah untuk sistem operasi Anda. Perintah ini menginstal paket Lightbuild CLI di Android SDK Anda, lalu menjalankan skrip penyiapan paket, yang menyalin Lightbuild CLI ke ~/.local/bin di macOS dan Linux, atau ke $HOME\AppData\LightbuildCLI di Windows, dan memastikan direktori tersebut ada di PATH Anda:

  • macOS dan Linux:

    android sdk install build/lightbuild/0.0.30 && bash "$(android info sdk)/build/lightbuild/0.0.30/cli/install.sh"

  • Windows (PowerShell):

    android sdk install build/lightbuild/0.0.30; if ($LASTEXITCODE -eq 0) { & "$(android info sdk)\build\lightbuild\0.0.30\cli\install.cmd" }

  • Windows (Command Prompt):

    android sdk install build/lightbuild/0.0.30 && for /f "delims=" %p in ('android info sdk') do call "%p\build\lightbuild\0.0.30\cli\install.cmd"

Setelah perintah selesai, verifikasi penginstalan.

Instal secara manual

Untuk menginstal Lightbuild CLI dan menambahkannya ke PATH sendiri, ikuti langkah-langkah berikut:

  1. Jika Anda tidak memiliki Android CLI, instal sekarang.

  2. Instal paket Lightbuild:

    android sdk install build/lightbuild/0.0.30

  3. Salin Lightbuild CLI ke direktori di PATH, sehingga Anda dapat menjalankan lightbuild dari direktori mana pun. Anda dapat menyalinnya ke direktori mana pun yang sudah ada di PATH, atau menggunakan direktori yang sama dengan yang digunakan skrip penyiapan:

    • macOS dan Linux: Salin file lightbuild ke ~/.local/bin:

      mkdir -p ~/.local/bin
cp "$(android info sdk)/build/lightbuild/0.0.30/cli/lightbuild" ~/.local/bin/

      Jika ~/.local/bin tidak ada di PATH, tambahkan baris berikut ke file startup shell Anda, seperti ~/.zshrc atau ~/.bashrc:

      export PATH="$PATH:$HOME/.local/bin"

    • Windows: Jalankan perintah berikut di PowerShell. Skrip ini menyalin lightbuild.exe ke $HOME\AppData\LightbuildCLI, dan menambahkan direktori tersebut ke Path pengguna Anda jika belum ada:

      $dir = "$HOME\AppData\LightbuildCLI"
New-Item -ItemType Directory -Force $dir | Out-Null
Copy-Item "$(android info sdk)\build\lightbuild\0.0.30\cli\lightbuild.exe" $dir
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if (($userPath -split ";") -notcontains $dir) { [Environment]::SetEnvironmentVariable("Path", "$userPath;$dir", "User") }

  4. Memverifikasi penginstalan

Memverifikasi penginstalan

Untuk memverifikasi bahwa Lightbuild CLI telah diinstal, periksa versinya:

lightbuild --version

Jika terminal Anda tidak dapat menemukan perintah lightbuild, buka jendela terminal baru agar perubahan PATH diterapkan.

Menemukan target build project Anda

Perintah CLI Lightbuild menggunakan target, yang mengidentifikasi bagian project Anda untuk di-build, diuji, atau diperiksa. Target dapat berupa nama modul, seperti app, atau sesuatu yang lebih spesifik, seperti app:app-debug.apk. Untuk mencocokkan semua target dalam modul, gunakan nama modul diikuti dengan /..., seperti app/.... Untuk mencocokkan semua target dalam project Anda, gunakan ....

Untuk mencantumkan semua target dalam project, buat kueri dari direktori root project:

lightbuild query ...

Untuk mencantumkan file yang dihasilkan target, tambahkan --output=files. Misalnya, untuk target app, jalankan:

lightbuild query app --output=files

Untuk mencantumkan perintah yang tersedia untuk project Anda, jalankan lightbuild help.

Membuat aplikasi

Untuk membangun target, jalankan lightbuild build dengan target. Misalnya, untuk mem-build modul app, jalankan:

lightbuild build app

Untuk mem-build semua target dalam project Anda, jalankan:

lightbuild build

Untuk menghapus output build dan cache project Anda, jalankan:

lightbuild clean

Menjalankan aplikasi

Lightbuild CLI akan mem-build aplikasi Anda, tetapi tidak menginstal atau menjalankannya. Untuk menjalankan aplikasi di perangkat terhubung atau emulator yang sedang berjalan, build aplikasi, lalu jalankan dengan perintah android run di Android CLI:

lightbuild build app
android run --apks=app/build/app-debug.apk

Untuk melihat tempat setiap target modul menulis outputnya, jalankan lightbuild query app/... --output=files. Lokasi bersifat relatif terhadap direktori modul.

Menjalankan pengujian

Untuk menjalankan semua pengujian dalam project Anda, jalankan:

lightbuild test

Perintah ini menjalankan pengujian lokal, yang berjalan di mesin pengembangan, dan pengujian berinstrumen, yang berjalan di perangkat yang terhubung atau emulator yang berjalan.

Untuk menjalankan pengujian dalam satu modul, tambahkan target modul, seperti app-core. Untuk menjalankan satu jenis pengujian saja, tambahkan :hostTest untuk pengujian lokal atau :deviceTest untuk uji instrumentasi ke target modul. Contoh:

lightbuild test app-core:hostTest
lightbuild test app-core:deviceTest

Menyelesaikan dependensi

Setiap modul mencatat dependensi yang telah diselesaikan dalam file resolved.deps. Untuk membuat file resolved.deps untuk modul, jalankan lightbuild resolve dengan target modul. Misalnya, untuk modul app, jalankan:

lightbuild resolve app

Untuk me-resolve semua target dalam project Anda, jalankan:

lightbuild resolve

Untuk mengetahui informasi selengkapnya, lihat Dependensi yang diselesaikan.