Crea progetti Lightbuild dalla riga di comando

L'interfaccia a riga di comando di Lightbuild è lo strumento a riga di comando ufficiale di Lightbuild. Utilizza il comando lightbuild per creare e testare il progetto, trovare i target di build e risolvere le dipendenze. I tuoi agenti AI possono eseguire gli stessi comandi. I progetti che crei da un template Lightbuild includono un file AGENTS.md che indica agli agenti AI come lavorare con Lightbuild e l'interfaccia a riga di comando di Lightbuild.

Per saperne di più sui comandi e sulle opzioni dell'interfaccia a riga di comando Lightbuild, consulta il Riferimento dell'interfaccia a riga di comando Lightbuild.

Installa l'interfaccia a riga di comando Lightbuild

La CLI Lightbuild viene distribuita come SDK Android che installi con la CLI Android. Puoi installarlo e configurarlo con un singolo comando o installarlo manualmente.

Installa e configura in un solo passaggio

Per installare l'interfaccia a riga di comando Lightbuild, esegui il comando per il tuo sistema operativo. Il comando installa il pacchetto Lightbuild CLI nel tuo SDK Android, quindi esegue lo script di configurazione del pacchetto, che copia Lightbuild CLI in ~/.local/bin su macOS e Linux o in $HOME\AppData\LightbuildCLI su Windows e si assicura che la directory sia in PATH:

  • macOS e 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 (prompt dei comandi):

    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"

Al termine del comando, verifica l'installazione.

Installa manualmente

Per installare l'interfaccia a riga di comando Lightbuild e aggiungerla autonomamente al tuo PATH, segui questi passaggi:

  1. Se non hai la CLI Android, installala.

  2. Installa il pacchetto Lightbuild:

    android sdk install build/lightbuild/0.0.30

  3. Copia l'interfaccia a riga di comando di Lightbuild in una directory nel tuo PATH, in modo da poter eseguire lightbuild da qualsiasi directory. Puoi copiarlo in qualsiasi directory già presente nel tuo PATH o utilizzare la stessa directory utilizzata dallo script di configurazione:

    • macOS e Linux: copia il file lightbuild in ~/.local/bin:

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

      Se ~/.local/bin non è presente in PATH, aggiungi la riga seguente al file di avvio della shell, ad esempio ~/.zshrc o ~/.bashrc:

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

    • Windows: esegui i seguenti comandi in PowerShell. Copiano lightbuild.exe in $HOME\AppData\LightbuildCLI e aggiungono la directory alla variabile Path dell'utente, se non è già presente:

      $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. Verifica l'installazione

Verifica l'installazione

Per verificare che l'interfaccia a riga di comando Lightbuild sia installata, controlla la sua versione:

lightbuild --version

Se il terminale non riesce a trovare il comando lightbuild, apri una nuova finestra del terminale in modo che le modifiche a PATH vengano applicate.

Trova i target di build del progetto

I comandi dell'interfaccia a riga di comando di Lightbuild accettano un target, che identifica la parte del progetto da creare, testare o ispezionare. Un target può essere il nome di un modulo, ad esempio app, o qualcosa di più specifico, ad esempio app:app-debug.apk. Per trovare una corrispondenza con tutte le destinazioni in un modulo, utilizza il nome del modulo seguito da /..., ad esempio app/.... Per trovare tutti i target nel progetto, utilizza ....

Per elencare tutti i target del progetto, eseguine una query dalla directory root del progetto:

lightbuild query ...

Per elencare i file prodotti da un target, aggiungi --output=files. Ad esempio, per il target app, esegui:

lightbuild query app --output=files

Per elencare i comandi disponibili per il tuo progetto, esegui lightbuild help.

Crea la tua app

Per creare un target, esegui lightbuild build con il target. Ad esempio, per creare il modulo app, esegui:

lightbuild build app

Per creare tutti i target nel tuo progetto, esegui:

lightbuild build

Per rimuovere l'output di build e le cache del progetto, esegui:

lightbuild clean

Esegui l'app

L'interfaccia a riga di comando Lightbuild crea l'app, ma non la installa né la esegue. Per eseguire l'app su un dispositivo connesso o su un emulatore in esecuzione, crea l'app, quindi eseguila con il comando android run in CLI Android:

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

Per vedere dove ogni target di un modulo scrive il proprio output, esegui lightbuild query app/... --output=files. Le posizioni sono relative alla directory del modulo.

Esegui test

Per eseguire tutti i test nel progetto, esegui:

lightbuild test

Questo comando esegue i test locali, che vengono eseguiti sulla macchina di sviluppo, e i test di instrumentazione, che vengono eseguiti su un dispositivo connesso o su un emulatore in esecuzione.

Per eseguire i test in un modulo, aggiungi la destinazione del modulo, ad esempio app-core. Per eseguire un solo tipo di test, aggiungi :hostTest per i test locali o :deviceTest per i test di instrumentazione alla destinazione del modulo. Ad esempio:

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

Risolvi le dipendenze

Ogni modulo registra le proprie dipendenze risolte in un file resolved.deps. Per generare il file resolved.deps per un modulo, esegui lightbuild resolve con il target del modulo. Ad esempio, per il modulo app, esegui:

lightbuild resolve app

Per risolvere tutti i target nel progetto, esegui:

lightbuild resolve

Per saperne di più, consulta Dipendenze risolte.