Übersicht über die Android-Befehlszeile

Die Android-Befehlszeile ist eine Befehlszeile, mit der Sie Android-Apps effizienter mit einem Tool Ihrer Wahl erstellen können. Sie standardisiert die wichtigsten Entwicklungskompetenzen für agentenorientierte Workflows und bietet einen Einstieg in die offiziellen Tools, Fähigkeiten und Kenntnisse, die Sie für eine effektivere Entwicklung benötigen. Außerdem können CI, Wartung und andere skriptbasierte Automatisierungen für die zunehmend verteilte Android-Entwicklung optimiert werden.

Die Android-Befehlszeile deckt den gesamten Entwicklungszyklus ab, vom Erstellen eines Projekts und Testen auf einem Gerät bis hin zum Profiling der Leistung und Untersuchen des Verhaltens in der Praxis. Ein Agent oder Script kann die Befehlszeile beispielsweise für folgende Aufgaben verwenden:

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

Eine vollständige Beschreibung der Android-Befehlszeilenbefehle und ‑optionen finden Sie in der Referenz zu Android-Befehlszeilenbefehlen.

Android-Befehlszeile installieren

So installieren Sie die Android-Befehlszeile:

  1. Android CLI herunterladen

  2. Aktualisieren Sie die Android-Befehlszeile, um sicherzustellen, dass Sie die aktuelle 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.

Einrichtung für Kundenservicemitarbeiter

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

Erhobene Daten

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

  • Aufrufe des Befehls android und der Unterbefehle, z. B. android run und android create.
  • Namen von nicht-positionalen Argumenten oder Optionen, die verwendet werden, z. B. --sdk oder --version.
  • Positionsargumente und Flag-Werte, die einer festen, vordefinierten Gruppe von Systemoptionen zugeordnet sind, die von der Android CLI verwaltet werden. Wir erfassen beispielsweise Emulatorvorlagennamen wie medium_phone und large_desktop sowie Agentennamen wie GEMINI, CLAUDE oder CODEX.
  • Stacktraces und Ausnahmemeldungen, wobei personenidentifizierbare Informationen vor der Erfassung anonymisiert werden, um den Datenschutz zu gewährleisten.

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

  • Wir erfassen keine Antworten der Befehlszeile, wenn ein Befehl ausgeführt wird.
  • Wir erfassen keine von Nutzern erstellten Eingaben oder externen Kennungen, die an die Befehlszeile ü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, aber der Wert com.company.internal.app wird 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.

Android CLI konfigurieren

Erstellen Sie eine .androidrc-Datei, um Flags und Optionen automatisch anzuwenden, wenn Sie die Android-Befehlszeile 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, eine 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-CLI-Befehlen verwenden können.

-h, --help

Verwendung: android <command> -h

Beschreibung: Zeigt die Hilfe 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 die globalen Umgebungsvariablen zu ändern, wenn Sie wechseln möchten. 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: Ausführliche Ausgabe aktivieren. 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 Referenz zu Android-Befehlszeilenbefehlen.