Gibt den Layoutbaum einer App zurück.
Nutzung
android layout [-dhp] [--device=PARAM] [--flat] [--full] [--no-idle] [--output=PARAM]
Optionen
--device=PARAM– Die Seriennummer des Geräts.-d,--diff: Eingestellt; No-Op-Flag. Wird in einer zukünftigen Version entfernt.--flat: Gibt eine flache Liste anstelle eines Baums zurück.--full: Gibt den vollständigen Baum zurück, einschließlich nicht interaktiver und ausgeblendeter Elemente.-h,--help– Zeigt die Hilfemeldung für den angegebenen Befehl an.--no-idle– Beim Abrufen des Layouts wird nicht auf den Leerlaufstatus des Layouts gewartet.-o,--output=PARAM: Schreibt das Layout in die angegebene Datei oder das angegebene Verzeichnis. Wenn keine Angabe gemacht wird, wird die Ausgabe an die Standardausgabe gesendet.-p,--pretty: Gibt das zurückgegebene JSON-Dokument formatiert aus.
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
Mit android layout wird die Live-UI-Hierarchie des aktiven Bildschirms auf einem verbundenen Android-Gerät oder Emulator erfasst und im JSON-Format ausgegeben.
KI-Agents und Testskripts können android layout verwenden, um sichtbaren Text, Ressourcen-IDs, Barrierefreiheitsbeschreibungen, Interaktionsstatus und Elementgrenzen zu prüfen, ohne sich ausschließlich auf visuelle Screenshots zu verlassen.
Layoutausgabe formatieren und filtern
-p, --pretty: Formatiert die JSON-Ausgabe mit Einrückungen und Zeilenumbrüchen, um die Lesbarkeit zu verbessern.-o, --output: Schreibt das Layout-JSON in den angegebenen Dateipfad anstelle der Standardausgabe.--flat: Gibt eine flache JSON-Liste von UI-Knoten anstelle eines verschachtelten Hierarchiestrukturbaums aus.--full: Enthält nicht interaktive und ausgeblendete UI-Elemente, die standardmäßig herausgefiltert werden.--no-idle: Erfasst das Layout sofort, ohne darauf zu warten, dass der UI-Thread der App in den Leerlauf wechselt.
Beispiele
Gibt den formatierten UI-Layoutbaum des aktiven Bildschirms aus:
android layout --pretty
Speichern Sie die vollständige UI-Hierarchie (einschließlich nicht interaktiver Elemente) in einer Datei:
android layout --pretty --full --output=./hierarchy.json