Android-Ausführung

Erstellt, stellt bereit und startet eine Android-App auf einem verbundenen Gerät oder Emulator.

Nutzung

android run [-h] [--activity=PARAM] [--apks=PARAM] [--debug] [--device=PARAM] [--install-options=PARAM] [--type=PARAM] [--use-delta-install]

Optionen

  • --activity=PARAM: Der Name der Aktivität.
  • --apks=PARAM: Die Pfade zu den APKs, durch Kommas getrennt.
  • --debug – Im Debug-Modus ausführen.
  • --device=PARAM – Die Seriennummer des Geräts.
  • -h,--help – Zeigt die Hilfemeldung für den angegebenen Befehl an.
  • --install-options=PARAM: Zusätzliche Optionen oder Flags, die an die Installation des Paketmanagers übergeben werden sollen (z. B. -g, -d).
  • --type=PARAM: Der Komponententyp (ACTIVITY, WATCH_FACE, TILE, COMPLICATION, DECLARATIVE_WATCH_FACE, WEAR_WIDGET).
  • --use-delta-install: Schnelle Delta-Installation verwenden (beschleunigt inkrementelle Updates, da nur geänderter Code und geänderte Ressourcen übertragen werden; Standard: true).

android-Optionen:

  • --sdk=PARAM: Pfad zum Android SDK.
  • -v,--verbose: Aktiviert die ausführliche Ausgabe zur Fehlerbehebung.
  • -V,--version – Gibt Versionsinformationen aus und beendet den Vorgang.

Beschreibung

android run stellt eine oder mehrere APK-Dateien auf einem verbundenen Android-Gerät oder Emulator bereit und startet sofort die Ziel-App-Komponente.

Angeben, was ausgeführt werden soll (--type und --activity)

Standardmäßig wird mit android run die im App-Manifest deklarierte Standard-Hauptaktivität gestartet. Mit den folgenden Optionen können Sie überschreiben, was gestartet wird:

  • --activity: Gibt den Namen der Aktivitäts- oder Komponentenklasse an, die gestartet werden soll. Dies ist erforderlich, wenn im APK mehrere startfähige Aktivitäten deklariert sind.
  • --type: Gibt den Komponententyp an, der anstelle einer Standard-UI-Aktivität gestartet werden soll. Unterstützte Werte sind ACTIVITY, WATCH_FACE, TILE, COMPLICATION, DECLARATIVE_WATCH_FACE und WEAR_WIDGET.
  • --debug: Startet die App im Debug-Modus und wartet darauf, dass ein Debugger aus Android Studio oder ein Befehlszeilentool angehängt wird.

Beispiele

Ein einzelnes Debug-APK bereitstellen und die zugehörige Hauptaktivität auf dem standardmäßig verbundenen Gerät starten:

android run --apks=app/build/outputs/apk/debug/app-debug.apk

Mehrere Split-APKs auf einem bestimmten Emulator bereitstellen:

android run --device=emulator-5554 --apks=base.apk,density-hdpi.apk,lang-en.apk

APK bereitstellen und eine bestimmte Aktivität im Debug-Modus starten:

android run --debug --activity=.ui.MainActivity --apks=app-debug.apk