android studio render-compose-preview

Rendert eine Compose-Vorschau in Android Studio.

Nutzung

android studio render-compose-preview [-h] [--output-image-file=PARAM] [--pid=PARAM] [--print-semantics] [--project=PARAM] <path> <composable>

Optionen

  • -h,--help – Zeigt die Hilfemeldung für den angegebenen Befehl an.
  • --output-image-file=PARAM: Der Dateiname, in den das resultierende Bild geschrieben werden soll.
  • --pid=PARAM: Die Prozess-ID der Android Studio-Instanz, mit der eine Verbindung hergestellt werden soll.
  • --print-semantics – Wenn true, wird der semantische Baum ausgegeben.
  • --project=PARAM: Der Name oder Pfad des Projekts, das in Android Studio geöffnet ist und für das die Abfrage ausgeführt werden soll. Mit android studio check können Sie die Namen der verfügbaren Projekte abrufen.

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.

Positionsargumente

  • <path>: Der Pfad der Datei, die die Compose-Vorschau enthält, relativ zum aktuellen Verzeichnis oder absolut.
  • <composable>: Der Name des Composables.

Beschreibung

Mit android studio render-compose-preview wird eine @Preview-Funktion von Jetpack Compose mit der Layout-Rendering-Engine von Android Studio gerendert und optional der Baum der Barrierefreiheitssemantik ausgegeben.

Erfordert Android Studio Quail 2 oder höher.

Vorschauausgabe konfigurieren (--output-image-file und --print-semantics)

  • --output-image-file: Speichert die gerenderte PNG-Vorschau im angegebenen Dateipfad. Wenn Sie das Feld weglassen, wird eine temporäre PNG-Datei erstellt.
  • --print-semantics: Gibt den Baum der Barrierefreiheitssemantik der Compose-Vorschau im JSON-Format aus, damit KI-Agents interaktive Knoten, Text und Grenzen zusammen mit dem gerenderten visuellen Bild prüfen können.

Beispiele

Rendere HotelDetailScreenPreview zu preview_hotel.png und gib den Semantikbaum aus:

android studio render-compose-preview \
  --output-image-file=preview_hotel.png \
  --print-semantics \
  app/src/main/java/com/example/myapp/ui/DetailScreen.kt \
  HotelDetailScreenPreview