Lightbuild-Befehlszeilenreferenz

Die Lightbuild-Befehlszeile ist das offizielle Befehlszeilentool für Lightbuild. Auf dieser Seite werden die Befehle und Optionen beschrieben. Informationen zum Installieren der Lightbuild-Befehlszeile finden Sie unter Lightbuild-Befehlszeile installieren. Informationen zu gängigen Aufgaben wie dem Erstellen und Testen Ihres Projekts finden Sie unter Lightbuild-Projekte über die Befehlszeile erstellen.

Syntax

Die Lightbuild-Befehlszeile verwendet die folgende Syntax:

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

Es werden die folgenden globalen Optionen unterstützt:

Option Beschreibung
-V, --version Gibt Versionsinformationen aus und beendet den Vorgang.
-p, --project=path Der absolute Pfad zu Ihrem Projekt. Die Standardeinstellung ist das aktuelle Verzeichnis, das ein Projekt enthalten muss.

Führen Sie lightbuild help aus, um die verfügbaren Befehle aufzulisten. Wenn Sie Hilfe zu einem bestimmten Befehl benötigen, führen Sie lightbuild help [command] aus.

lightbuild build

Erstellt ein Ziel in Ihrem Projekt.

lightbuild build [target]
Argument Beschreibung
target Das zu erstellende Ziel. Standardmäßig werden alle Ziele unter dem aktuellen Verzeichnis verwendet.

Führen Sie beispielsweise Folgendes aus, um das Modul app zu erstellen:

lightbuild build app

Führen Sie folgenden Befehl aus, um alle Ziele in Ihrem Projekt zu erstellen:

lightbuild build

lightbuild clean

Entfernt die Build-Ausgabe und die Caches Ihres Projekts.

lightbuild clean [target]
Argument Beschreibung
target Das Ziel, das bereinigt werden soll. Standardmäßig werden alle Ziele unter dem aktuellen Verzeichnis verwendet.

Wenn Sie beispielsweise die Build-Ausgabe und die Caches für das gesamte Projekt entfernen möchten, führen Sie folgenden Befehl aus:

lightbuild clean

lightbuild help

Listet die verfügbaren Befehle auf oder zeigt die Hilfe für einen bestimmten Befehl an.

lightbuild help [COMMAND]
Argument Beschreibung
COMMAND Der Befehl, für den die Hilfe angezeigt werden soll. Standardmäßig werden alle Befehle verwendet.

Führen Sie den folgenden Befehl aus, um die für Ihr Projekt verfügbaren Befehle aufzulisten:

lightbuild help

Wenn Sie die Hilfe für einen bestimmten Befehl wie query aufrufen möchten, führen Sie Folgendes aus:

lightbuild help query

lightbuild query

Listet die Build-Ziele, generierten Ausgabedateien oder Source-Sets auf, die einem Muster in den Modulen Ihres Projekts entsprechen.

lightbuild query [target-pattern] [--format=format] [--output=type]
Option oder Argument Beschreibung
target-pattern Das Zielpfadmuster, z. B. ... oder app.
--format=format Das Ausgabeformat, z. B. json. Die Standardeinstellung ist eine Tabelle.
--output=type Das Format der Ausgabe: files für die Speicherorte der Dateien, die von den übereinstimmenden Zielen erzeugt werden, sourcesets für ihre Source-Sets oder sourceset_types für die Typen ihrer Source-Sets.

Führen Sie folgenden Befehl aus, um alle Ziele in Ihrem Projekt aufzulisten:

lightbuild query ...

Führen Sie folgenden Befehl aus, um die Speicherorte der Dateien auszugeben, die das Ziel app erzeugt:

lightbuild query app --output=files

lightbuild resolve

Löst die externen Abhängigkeiten Ihres Projekts auf und generiert die Offline-Abhängigkeitssperrdateien (resolved.deps) für die Module.

lightbuild resolve [--cache=path] [--locked-dependencies] [target]
Option oder Argument Beschreibung
target Das Modul, für das Abhängigkeiten aufgelöst werden sollen, z. B. app. Standardmäßig werden alle Ziele unter dem aktuellen Verzeichnis verwendet.
--locked-dependencies Wird mit einem Fehler beendet, wenn die lokale Abhängigkeitssperrdatei (resolved.deps) nicht synchron ist.
--cache=path Das Verzeichnis, in dem der Abhängigkeits-Cache gespeichert werden soll.

Wenn Sie beispielsweise die resolved.deps-Dateien für alle Module in Ihrem Projekt generieren möchten, führen Sie Folgendes aus:

lightbuild resolve

Weitere Informationen zu resolved.deps-Dateien finden Sie unter Aufgelöste Abhängigkeiten.

lightbuild test

Führt die Tests in Ihrem Projekt aus: lokale Tests, die auf Ihrem Entwicklungscomputer ausgeführt werden, und Instrumentierungstests, die auf einem verbundenen Gerät oder einem laufenden Emulator ausgeführt werden. Wenn Sie ein einzelnes Modul testen möchten, geben Sie das Ziel an, z. B. app-core. Wenn Sie nur einen Testtyp ausführen möchten, fügen Sie dem Ziel :hostTest für lokale Tests oder :deviceTest für Instrumentierungstests hinzu.

lightbuild test [target] [--locked-dependencies]
Option oder Argument Beschreibung
target Das zu testende Ziel. Standardmäßig werden alle Tests in Ihrem Projekt verwendet.
--locked-dependencies Der Build schlägt fehl, wenn die lokale Sperrdatei für Abhängigkeiten (resolved.deps) nicht synchron ist.

Wenn Sie beispielsweise alle Tests in Ihrem Projekt ausführen möchten, führen Sie Folgendes aus:

lightbuild test

Führen Sie die lokalen Tests im Modul app-core so aus:

lightbuild test app-core:hostTest

Führen Sie die Instrumentierungstests im Modul app-core auf einem Gerät oder Emulator aus:

lightbuild test app-core:deviceTest