Android-Build

Android-Artefakte erstellen

Nutzung

android build [-h] [<reference>] [-- <build_args>]

Optionen

  • -h,--help: Zeigt die Hilfemeldung für den angegebenen Befehl an.

Optionen für android:

  • --sdk=PARAM: Pfad zum Android SDK.
  • -v,--verbose: Aktiviert die ausführliche Ausgabe zur Fehlerbehebung.
  • -V,--version – Versionsinformationen ausgeben und beenden.

Positionsargumente

  • <reference> – Build-Referenz ([system://][path]?[target]).
  • -- <build_args>: Argumente, die unverändert an das Build-System übergeben werden. Verwenden Sie --, um sie von anderen Argumenten zu trennen.

Beschreibung

android build erkennt das Build-System eines Arbeitsbereichs (Gradle, Bazel, Soong, Lightbuild oder ein in der Android-CLI-Konfiguration deklariertes Build-System) und erstellt damit das angeforderte Ziel.

Übergeben Sie eine Build-Referenz ([system://][path]?[target]), um den Arbeitsbereich und das Ziel für den Build auszuwählen, oder lassen Sie <reference> weg, um das Standardziel im aktuellen Arbeitsbereich zu erstellen.

Referenzen erstellen

Eine Build-Referenz besteht aus drei optionalen Teilen:

  • system://: Erzwingt ein bestimmtes Build-System (z. B. gradle:// oder bazel://), anstatt es aus dem Arbeitsbereich zu erkennen.
  • path: Verzeichnis im Arbeitsbereich, aus dem erstellt werden soll, absolut oder relativ zum aktuellen Verzeichnis (standardmäßig das aktuelle Verzeichnis).
  • ?target: Was erstellt werden soll, in der Syntax des Build-Systems (z. B. ein Gradle-Projektpfad wie :app oder :app@debug oder ein Bazel-Label wie //app:app).

Das Trennzeichen ? ist immer erforderlich, wenn system:// oder path vorhanden ist (z. B. gradle://?, ./app? oder gradle://./app?:app). Ohne ? wird die gesamte Referenz als Ziel behandelt.

Argumente nach -- werden unverändert an das zugrunde liegende Build-System übergeben.

Beispiele

Erstellen Sie das Standardziel im aktuellen Arbeitsbereich:

android build

Erstellen Sie :app im aktuellen Gradle-Arbeitsbereich:

android build :app

Erstellen Sie die debug-Variante von :app (:app@debug) aus dem Gradle-Arbeitsbereich unter $HOME/my-app und übergeben Sie zusätzliche Argumente an Gradle:

android build $HOME/my-app?:app@debug -- --offline

Erstellen Sie ein Bazel-Ziel und erzwingen Sie das Bazel-Build-System:

android build bazel://?//app:app