Übersicht über die Android-Befehlszeile

Die Android-Befehlszeile ist eine Befehlszeilenschnittstelle, mit der Sie Android-Apps effizienter mit einem beliebigen Tool Ihrer Wahl erstellen können. Es standardisiert die wichtigsten Entwicklungskompetenzen für Agent-First-Workflows und bietet einen Einstiegspunkt für die offiziellen Tools, Fähigkeiten und das Wissen, die Sie für eine effektivere Entwicklung benötigen. Außerdem können CI, Wartung und andere automatisierte Abläufe für die zunehmend verteilte Android-Entwicklung optimiert werden.

Ein Agent oder Skript kann die CLI beispielsweise für die folgenden Aufgaben verwenden:

  • Umgebung und Android SDK-Einrichtung automatisieren
  • Neue Projekte aus Vorlagen erstellen
  • Virtuelle Geräte verwalten, APKs installieren und Live-Gerätebildschirme und UI-Hierarchien direkt über das Terminal untersuchen
  • Verbindung zu laufenden Android Studio-Instanzen für die semantische Codeanalyse, das Rendern der Compose-Vorschau und das Nachschlagen von Abhängigkeitsversionen herstellen
  • App mit Journeys testen

Die Android-Befehlszeile bietet Ihren Agents außerdem Zugriff auf Android-Skills und die spezielle Android-Wissensdatenbank, damit in Ihren Projekten die von Android empfohlenen Muster und Best Practices angewendet werden.

Eine vollständige Beschreibung der Android-Befehlszeilenbefehle und -Optionen finden Sie in der Android-Befehlszeilenreferenz.

Android-Befehlszeile installieren

So installieren Sie die Android-Befehlszeile:

  1. Android CLI herunterladen

  2. Aktualisieren Sie die Android-Befehlszeile, um sicherzugehen, dass Sie die neueste Version verwenden:

    android update

Wenn Sie prüfen möchten, ob die Android-CLI bereits auf Ihrem Computer installiert ist, führen Sie which android oder command -v android aus. Wenn ein Pfad zurückgegeben wird, ist sie installiert.

Für Agents einrichten

Damit Agents die Android CLI verstehen und verwenden können, führen Sie android init aus, um den android-cli-Skill zu installieren.

Erhobene Daten

Die Android-Befehlszeile erfasst Daten zur grundlegenden Nutzung des Tools. Folgende Daten werden von uns erhoben:

  • Aufrufe des Befehls android und seiner Unterbefehle, z. B. android run und android create.
  • Namen der verwendeten nicht positionellen Argumente oder Optionen, z. B. --sdk oder --version.
  • Positionsargumente und Flag-Werte, die einem festen, vordefinierten Satz von Systemoptionen zugeordnet sind, die von der Android-Befehlszeile verwaltet werden. Wir erfassen beispielsweise Namen von Emulatortemplates wie medium_phone und large_desktop sowie Namen von Agents wie GEMINI, CLAUDE oder CODEX.
  • Stacktraces und Fehlermeldungen, in denen personenidentifizierbare Informationen vor der Erhebung anonymisiert werden, um den Datenschutz zu gewährleisten.

Hier einige Beispiele für Daten, die wir nicht erheben:

  • Wir erfassen keine Antworten der CLI, wenn ein Befehl ausgeführt wird.
  • Wir erheben keine von Nutzern erstellten Eingaben oder externen Kennungen, die an die CLI übergeben werden, z. B. bestimmte Maven-Koordinaten, lokale Dateipfade oder benutzerdefinierte Projektnamen. Wenn beispielsweise der Befehl android create --name=com.company.internal.app ausgeführt wird, wird aufgezeichnet, dass android create mit dem Argument --name ausgeführt wurde. Der Wert com.company.internal.app wird jedoch nicht gespeichert.

Wenn Sie die Datenerhebung deaktivieren möchten, verwenden Sie das Flag --no-metrics, wenn Sie einen Befehl mit der Android-Befehlszeile ausführen.

Feedback und Probleme

Wenn Probleme auftreten oder Sie Feedback geben möchten, melden Sie einen Fehler.

Bekannte Probleme

  • Der Befehl android emulator für Windows ist derzeit deaktiviert.
  • Das Herunterladen der Android-Befehlszeile über Windows PowerShell wird derzeit nicht unterstützt.

Android-Befehlszeile konfigurieren

Erstellen Sie eine .androidrc-Datei, um Flags und Optionen automatisch anzuwenden, wenn Sie die Android-CLI aufrufen. Speichern Sie die Datei je nach Betriebssystem am folgenden Speicherort:

  • macOS und Linux: ~/.androidrc
  • Windows: %USERPROFILE%\.androidrc

Fügen Sie die Flags hinzu, die automatisch auf die Datei angewendet werden sollen, eines pro Zeile.

Wenn Sie beispielsweise möchten, dass die Android-Befehlszeile standardmäßig immer ein bestimmtes Android SDK verwendet, fügen Sie Ihrer Datei das Flag --sdk hinzu:

--sdk=<path-to-sdk>

Globale Optionen

Dies sind optionale Flags, die Sie mit anderen Android-Befehlszeilenbefehlen verwenden können.

-h, --help

Verwendung:android <command> -h

Beschreibung:Zeigt das Hilfemanual für das Tool oder den betreffenden Befehl an.

Beispiele:

  • android -h
  • android create -h

--sdk

Verwendung:android --sdk=<path-to-sdk> <command>

Beschreibung:Der Pfad zum Android SDK, das Sie für den folgenden Befehl verwenden möchten. Mit der Einstellung --sdk können Sie das Standard-Android-SDK vorübergehend überschreiben, anstatt jedes Mal, wenn Sie wechseln möchten, Ihre globalen Umgebungsvariablen zu ändern. Führen Sie android info aus, um zu prüfen, welches Android SDK Sie standardmäßig verwenden.

Beispiel: android --sdk=<path/to/sdk> sdk list

-v, --verbose

Verwendung:android -v <command>

Beschreibung:Aktivieren Sie die ausführliche Ausgabe. Geben Sie mehrere -v-Optionen an, um die Ausführlichkeit zu erhöhen (z. B. -v, -vv oder -vvv).

-V, --version

Verwendung:android -V

Beschreibung:Gibt Versionsinformationen aus und beendet den Vorgang.

Befehle

Eine vollständige Beschreibung der Android-Befehlszeilenbefehle und -Optionen finden Sie in der Android-Befehlszeilenreferenz.