Android CLI Spezialist
Dieser Skill bietet Anweisungen zur Verwendung des android CLI-Werkzeugs. Das Tool enthält verschiedene Befehle zum Erstellen von Projekten, Ausführen von Anwendungen, Interagieren mit Geräten und Verwalten der CLI-Umgebung.
Installation
Wenn das android-Werkzeug nicht im Pfad ist, installieren Sie es. Führen Sie dazu den folgenden Befehl aus:
Linux: curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash
Mac Arm: curl -fsSL https://dl.google.com/android/cli/latest/darwin_arm64/install.sh | bash
Mac Intel: curl -fsSL https://dl.google.com/android/cli/latest/darwin_x86_64/install.sh | bash
Windows: curl -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install.cmd -o "%TEMP%\i.cmd" && "%TEMP%\i.cmd"
SDK-Verwaltung
Zur Verwaltung der Installation von Android SDKs und Werkzeugen verwenden Sie den Befehl sdk. Zum Beispiel:
android sdk install <paket>[@<version>]...: Installiert bestimmte Pakete. Mehrere Pakete können durch Leerzeichen getrennt angegeben werden.<version>standardmäßig auf die neueste Version. Beispiel:android sdk install platforms/android-30@2 platforms/android-34android sdk update [<pkg-name>]: Aktualisiert ein bestimmtes Paket oder alle Pakete auf die neueste Version.android sdk remove <pkg-name>: Entfernt ein Paket aus dem lokalen SDK.android sdk list --all: Listet installierte und verfügbare SDK-Pakete auf.
Projekterstellung
Erstellen Sie Projekte aus Vorlagen mit dem Befehl create.
Zum Beispiel: android create empty-activity --name="Meine App" --output=./my-app
Interaktion mit Android-Geräten
Verwenden Sie den Befehl android layout, um das UI-Layout einer Android-Anwendung im JSON-Format zu inspizieren.
Verwenden Sie den Befehl android screen, um die UI visuell zu inspizieren und Begrenzungskoordinaten für visuelle Bereiche zu erhalten.
WICHTIG: Bevor Sie android layout oder android screen verwenden, MÜSSEN Sie diese Referenz lesen: interact.md
Die Referenzdatei interact.md enthält Anweisungen zur ordnungsgemäßen Interaktion mit Android-Geräten. Befolgen Sie deren Anweisungen genau.
Ausführen von Journey-Tests
Journey-Tests beinhalten Geräteinteraktion; verwenden Sie die Befehle android layout und android screen, um Journeys zu bewerten.
Auch hier gelten die Anweisungen zur Geräteinteraktion.
WICHTIG: Bevor Sie eine Journey bewerten, MÜSSEN Sie diese Referenz lesen: journeys.md Die Referenzdatei journeys.md enthält Anweisungen zur korrekten Bewertung einer Android-Journey. Befolgen Sie deren Anweisungen genau.
Dokumentsuche
Der Befehl docs durchsucht maßgebliche, hochwertige Android-Entwicklerdokumentation in der Android-Wissensdatenbank.
Durch die Angabe weniger Schlüsselwörter gibt dieses Werkzeug hochwertige Artikel zurück, die Beispiele oder Anleitungen zur Verwendung von Android-APIs oder -Bibliotheken enthalten.
Verwenden Sie dieses Werkzeug, um zusätzliche Informationen zur Durchführung Android-spezifischer Aufgaben zu erhalten oder mehr über Android-APIs, Oberflächen, Bibliotheken oder Geräte zu erfahren.
Verwenden Sie dieses Werkzeug immer, um die aktuellsten Informationen zu Android-Konzepten zu erhalten. Typische gute Anwendungsfälle sind:
- Finden von Migrationsleitfäden für APIs.
- Finden von Beispielen für APIs.
- Finden aktueller Informationen zu Android-APIs.
- Finden von Best Practices für Android-Konzepte.
Ausführen von APKs
Verwenden Sie den Befehl run, um Android-Apps auszuführen.
Verwalten von Emulatoren
Verwalten Sie Android Virtual Devices (AVDs) mit dem Befehl android emulator.
Erstellen von Screenshots
Erfassen Sie ein Bild des aktuellen Bildschirms eines verbundenen Android-Geräts und geben Sie es mit dem Befehl android screen in eine Datei aus.
Verwalten von Skills
Verwalten Sie Agenten-Skills für Android mit dem Befehl android skills.
Aktualisieren der CLI
Aktualisieren Sie die Android-CLI mit dem Befehl android update.
Ausgabe von android help
Usage: android [-Vhv] [--sdk=PARAM] [COMMAND]
-h, --help Hilfe zu diesem Befehl anzeigen
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung aktivieren
-V, --version Versionsinformationen anzeigen und beenden
Commands:
completion Installiert die Shell-Autovervollständigungskonfiguration für die Android-CLI im aktuellen Benutzerprofil
create Erstellt ein neues Android-Projekt aus verfügbaren Vorlagen. Ermöglicht die Angabe von Projektname, Ausgabeverzeichnis, minSdk und Trockenlauf-Ausführung
describe Analysiert ein Android-Projekt, um beschreibende Metadaten zu generieren. Dieser Befehl identifiziert und gibt die Pfade zu JSON-Dateien aus, die die Projektstruktur detailliert beschreiben, einschließlich Build-Zielen und deren entsprechenden Ausgabeartefakt-Speicherorten (z.B. APKs). Diese Informationen ermöglichen es anderen Werkzeugen und Befehlen, Build-Artefakte effizient zu finden
docs Android-Dokumentationsbefehle zum Suchen und Abrufen von Entwicklerdokumentation aus der offiziellen Wissensdatenbank
emulator Verwaltet Android Virtual Devices (AVDs). Enthält Befehle zum Starten, Stoppen, Auflisten und Anzeigen von Details zu Emulatoren
help Zeigt die Hilfe aller Befehle an
info Gibt Umgebungsinformationen aus, einschließlich SDK-Speicherort, verbundener Geräte und Konfigurationsvariablen. Verwenden Sie bestimmte Felder, um die Ausgabe einzugrenzen
init Initialisiert die Umgebung für die Android-CLI. Richtet erforderliche Konfigurationen, Verzeichnisse und Standard-Skills ein
install Installiert eine Android-Anwendung (ein oder mehrere APKs) auf einem verbundenen Gerät oder Emulator, ohne Komponenten zu aktivieren, mit inkrementellen Optimierungen für eine schnellere Bereitstellung als adb
layout Gibt den Layout-Baum einer Anwendung zurück
run Erstellt, bereitstellt und startet eine Android-Anwendung auf einem verbundenen Gerät oder Emulator
screen Befehle zum Anzeigen des Geräts
sdk Verwaltet die Android SDK-Installation. Enthält Befehle zum Installieren, Aktualisieren, Entfernen und Auflisten verfügbarer und installierter SDK-Pakete
skills Verwaltet Android-CLI-Skills. Enthält Befehle zum Installieren, Entfernen, Auflisten und Suchen nach Skills nach Schlüsselwort
studio Android Studio-Befehle
update Aktualisiert die Android-CLI auf die neueste Version
completion
Usage: android completion [-h] [<shell>]
Installiert die Shell-Autovervollständigungskonfiguration für die Android-CLI im aktuellen Benutzerprofil
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung aktivieren
-V, --version Versionsinformationen anzeigen und beenden
Positional Parameters:
<shell> Wenn angegeben, die Vervollständigung für die angegebene Shell ausgeben, ohne zu installieren. Unterstützt: bash, zsh
create
Usage: android create [-h] [--application-id=PARAM] [--list] [--min-sdk=PARAM]
[--name=PARAM] [--namespace=PARAM] [--output=PARAM]
[<template-name>]
Erstellt ein neues Android-Projekt aus verfügbaren Vorlagen. Ermöglicht die Angabe von Projektname, Ausgabeverzeichnis, minSdk und Trockenlauf-Ausführung
Options:
--application-id=PARAM Die Anwendungs-ID für die Anwendung
(z.B. 'com.beispiel.meineapp')
-h, --help Hilfe zu diesem Befehl anzeigen
--list Alle verfügbaren Vorlagen auflisten
--min-sdk=PARAM Der von der Anwendung unterstützte 'minSdk'
(Standard ist in der Vorlage definiert)
--name=PARAM Der Name der Anwendung (z.B. 'Meine
Anwendung')
--namespace=PARAM Der Namespace für Ressourcen und Paketname
für Kotlin-Quelldateien
-o, --output=PARAM Das Zielprojektverzeichnis (Standard
ist '.')
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Positional Parameters:
<template-name> Der Vorlagenname
describe
Usage: android describe [-h] [--project_dir=PARAM]
Analysiert ein Android-Projekt, um beschreibende Metadaten zu generieren. Dieser Befehl identifiziert und gibt die Pfade zu JSON-Dateien aus, die die Projektstruktur detailliert beschreiben, einschließlich Build-Zielen und deren entsprechenden Ausgabeartefakt-Speicherorten (z.B. APKs). Diese Informationen ermöglichen es anderen Werkzeugen und Befehlen, Build-Artefakte effizient zu finden
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
--project_dir=PARAM Das zu beschreibende Projektverzeichnis
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
docs
Usage: android docs [-h] [COMMAND]
Android-Dokumentationsbefehle zum Suchen und Abrufen von Entwicklerdokumentation aus der offiziellen Wissensdatenbank
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Commands:
fetch Ruft einen Android-Dokumentationsartikel von einer URL ab (kb://...)
search Durchsucht die Android-Dokumentation. Schlüsselwörter in Anführungszeichen setzen
emulator
Usage: android emulator [-h] [COMMAND]
Verwaltet Android Virtual Devices (AVDs). Enthält Befehle zum Starten, Stoppen, Auflisten und Anzeigen von Details zu Emulatoren
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Commands:
create Erstellt ein virtuelles Gerät
list Listet verfügbare virtuelle Geräte auf
remove Löscht ein virtuelles Gerät
start Startet das angegebene virtuelle Gerät. Dieser Befehl kehrt zurück, wenn der Emulator vollständig gestartet und einsatzbereit ist
stop Stoppt das angegebene virtuelle Gerät
help
Usage: android help [-h] [COMMAND]
Zeigt die Hilfe aller Befehle an
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Positional Parameters:
COMMAND Der Befehl, für den Hilfe angezeigt werden soll
info
Usage: android info [-h] [<field>]
Gibt Umgebungsinformationen aus, einschließlich SDK-Speicherort, verbundener Geräte und Konfigurationsvariablen. Verwenden Sie bestimmte Felder, um die Ausgabe einzugrenzen
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Positional Parameters:
<field> Das spezifische Feld, dessen Wert ausgegeben werden soll. Wenn nicht angegeben, wird alles ausgegeben
init
Usage: android init [-h]
Initialisiert die Umgebung für die Android-CLI. Richtet erforderliche Konfigurationen, Verzeichnisse und Standard-Skills ein
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
install
Usage: android install [-h] [--apks=PARAM] [--device=PARAM] [--install-options=PARAM]
[--use-delta-install]
Installiert eine Android-Anwendung (ein oder mehrere APKs) auf einem verbundenen Gerät oder Emulator, ohne Komponenten zu aktivieren, mit inkrementellen Optimierungen für eine schnellere Bereitstellung als adb
Options:
--apks=PARAM Die Pfade zu den APKs, durch Komma getrennt
--device=PARAM Die Seriennummer des Geräts
-h, --help Hilfe zu diesem Befehl anzeigen
--install-options=PARAM Zusätzliche Optionen/Flags, die an die Paketverwaltungsinstallation übergeben werden sollen (z.B. -g,-d)
--use-delta-install Schnelle Delta-Installation verwenden (beschleunigt inkrementelle Aktualisierungen durch Übertragung nur geänderter Code- und Ressourcen; Standard: true)
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Positional Parameters:
[APK_PATH]... Die APK-Dateien, die installiert werden sollen
layout
Usage: android layout [-h]
Gibt den Layout-Baum einer Anwendung zurück
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
run
Usage: android run [-h] [--app-id=PARAM] [--args=PARAM] [--device=PARAM]
Erstellt, stellt bereit und startet eine Android-Anwendung auf einem verbundenen Gerät oder Emulator
Options:
--app-id=PARAM Die Anwendungs-ID (z.B. 'com.beispiel.meineapp')
--args=PARAM Zusätzliche Argumente, die an die Anwendung übergeben werden sollen
--device=PARAM Die Seriennummer des Geräts
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Positional Parameters:
[APK_PATH] Pfad zur APK-Datei
screen
Usage: android screen [-h] [COMMAND]
Befehle zum Anzeigen des Geräts
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Commands:
capture Erfasst einen Screenshot des aktuellen Gerätebildschirms
view Zeigt eine visuelle Darstellung des Gerätebildschirms.
Nützlich, wenn der Benutzer nach dem sucht, was auf dem Gerät ist
sdk
Usage: android sdk [-h] [COMMAND]
Verwaltet die Android SDK-Installation. Enthält Befehle zum Installieren, Aktualisieren, Entfernen und Auflisten verfügbarer und installierter SDK-Pakete
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Commands:
install Installiert SDK-Pakete.
list Listet installierte und verfügbare SDK-Pakete auf
remove Entfernt ein Paket aus dem lokalen SDK
update Aktualisiert ein bestimmtes Paket oder alle Pakete auf die neueste Version
skills
Usage: android skills [-h] [COMMAND]
Verwaltet Android-CLI-Skills. Enthält Befehle zum Installieren, Entfernen, Auflisten und Suchen nach Skills nach Schlüsselwort
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Commands:
install Installiert einen Skill.
list Listet installierte Skills auf
remove Entfernt einen installierten Skill
search Sucht in Skills nach Schlüsselwort
studio
Usage: android studio [-h] [COMMAND]
Android Studio-Befehle
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden
Commands:
launch Startet Android Studio
open Öffnet ein Android-Projekt in Android Studio
update
Usage: android update [-h]
Aktualisiert die Android-CLI auf die neueste Version
Options:
-h, --help Hilfe zu diesem Befehl anzeigen
android options:
--sdk=PARAM Pfad zum Android SDK
-v, --verbose Ausführliche Ausgabe für Fehlerbehebung
-V, --version Versionsinformationen anzeigen und beenden