Riferimento per l'interfaccia a riga di comando di Lightbuild

L'interfaccia a riga di comando di Lightbuild è lo strumento a riga di comando ufficiale di Lightbuild. Questa pagina descrive i relativi comandi e opzioni. Per installare l'interfaccia a riga di comando Lightbuild, vedi Installa l'interfaccia a riga di comando Lightbuild. Per le attività comuni, come la creazione e il test del progetto, consulta Crea progetti Lightbuild dalla riga di comando.

Sintassi

L'interfaccia a riga di comando di Lightbuild utilizza la seguente sintassi:

lightbuild [-V] [--project=path] [COMMAND]

Supporta le seguenti opzioni globali:

Opzione Descrizione
-V, --version Stampa le informazioni sulla versione ed esce.
-p, --project=path Il percorso assoluto del progetto. Per impostazione predefinita, è la directory corrente, che deve contenere un progetto.

Per elencare i comandi disponibili, esegui lightbuild help. Per ricevere assistenza per un comando specifico, esegui lightbuild help [command].

lightbuild build

Crea un target nel tuo progetto.

lightbuild build [target]
Argomento Descrizione
target Il target da creare. Per impostazione predefinita, vengono mostrate tutte le destinazioni nella directory corrente.

Ad esempio, per creare il modulo app, esegui:

lightbuild build app

Per creare tutti i target nel tuo progetto, esegui:

lightbuild build

lightbuild clean

Rimuove l'output di build e le cache del progetto.

lightbuild clean [target]
Argomento Descrizione
target La destinazione da pulire. Per impostazione predefinita, vengono mostrate tutte le destinazioni nella directory corrente.

Ad esempio, per rimuovere l'output della build e le cache per l'intero progetto, esegui:

lightbuild clean

lightbuild help

Elenca i comandi disponibili o mostra la guida per un comando specifico.

lightbuild help [COMMAND]
Argomento Descrizione
COMMAND Il comando per cui mostrare la guida. Il valore predefinito è tutti i comandi.

Per elencare i comandi disponibili per il tuo progetto, esegui:

lightbuild help

Per visualizzare la guida di un comando specifico, ad esempio query, esegui:

lightbuild help query

lightbuild query

Elenca i target di build, i file di output generati o i set di risorse che corrispondono a un pattern nei moduli del progetto.

lightbuild query [target-pattern] [--format=format] [--output=type]
Opzione o argomento Descrizione
target-pattern Il pattern del percorso di destinazione, ad esempio ... o app.
--format=format Il formato di output, ad esempio json. Il valore predefinito è una tabella.
--output=type Il formato dell'output: files per le posizioni dei file prodotti dai target corrispondenti, sourcesets per i relativi set di risorse o sourceset_types per i tipi dei relativi set di risorse.

Per elencare tutti i target nel tuo progetto, esegui:

lightbuild query ...

Per stampare le posizioni dei file prodotti dalla destinazione app, esegui:

lightbuild query app --output=files

lightbuild resolve

Risolve le dipendenze esterne del progetto e genera i file di blocco delle dipendenze offline (resolved.deps) per i relativi moduli.

lightbuild resolve [--cache=path] [--locked-dependencies] [target]
Opzione o argomento Descrizione
target Il modulo per cui risolvere le dipendenze, ad esempio app. Per impostazione predefinita, vengono mostrate tutte le destinazioni nella directory corrente.
--locked-dependencies Esce con un errore se il file di blocco delle dipendenze locali (resolved.deps) non è sincronizzato.
--cache=path La directory in cui archiviare la cache delle dipendenze.

Ad esempio, per generare i file resolved.deps per tutti i moduli del tuo progetto, esegui:

lightbuild resolve

Per saperne di più sui file resolved.deps, consulta Dipendenze risolte.

lightbuild test

Esegue i test nel progetto: test locali, che vengono eseguiti sulla macchina di sviluppo, e test di instrumentazione, che vengono eseguiti su un dispositivo connesso o su un emulatore in esecuzione. Per testare un modulo, specifica la sua destinazione, 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.

lightbuild test [target] [--locked-dependencies]
Opzione o argomento Descrizione
target Il target da testare. Per impostazione predefinita, vengono eseguiti tutti i test del progetto.
--locked-dependencies La build non va a buon fine se il file di blocco delle dipendenze locale (resolved.deps) non è sincronizzato.

Ad esempio, per eseguire tutti i test nel progetto, esegui:

lightbuild test

Per eseguire i test locali nel modulo app-core, esegui:

lightbuild test app-core:hostTest

Per eseguire i test di instrumentazione nel modulo app-core su un dispositivo o un emulatore, esegui:

lightbuild test app-core:deviceTest