android studio render-compose-preview

Renderuje podgląd Compose w Android Studio.

Wykorzystanie

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

Opcje

  • -h,--help – wyświetla komunikat pomocy dotyczący określonego polecenia.
  • --output-image-file=PARAM – nazwa pliku, w którym ma zostać zapisany wynikowy obraz.
  • --pid=PARAM – identyfikator PID instancji Android Studio, z którą chcesz się połączyć.
  • --print-semantics – jeśli true, drukuje drzewo semantyczne.
  • --project=PARAM – nazwa lub ścieżka projektu otwartego w Android Studio, do którego chcesz wysłać zapytanie. Użyj android studio check, aby uzyskać nazwy dostępnych projektów.

Opcje: android

  • --sdk=PARAM – Ścieżka do pakietu SDK na Androida.
  • -v,--verbose – włącza szczegółowe dane wyjściowe na potrzeby rozwiązywania problemów.
  • -V,--version – wyświetla informacje o wersji i zamyka program.

Argumenty pozycyjne

  • <path> – ścieżka do pliku zawierającego podgląd Compose, względna względem bieżącego katalogu lub bezwzględna.
  • <composable> – nazwa funkcji kompozycyjnej.

Opis

android studio render-compose-preview renderuje funkcję @Preview Jetpack Compose za pomocą silnika renderowania układu Androida Studio i opcjonalnie wyświetla drzewo semantyki ułatwień dostępu.

Wymaga Androida Studio Quail 2 lub nowszego.

Konfigurowanie danych wyjściowych podglądu (--output-image-file i --print-semantics)

  • --output-image-file: zapisuje wyrenderowany podgląd PNG w określonej ścieżce pliku. Jeśli ten parametr zostanie pominięty, utworzony zostanie tymczasowy plik PNG.
  • --print-semantics: wyświetla drzewo semantyczne dostępności podglądu Compose w formacie JSON, aby agenci AI mogli sprawdzać węzły interaktywne, tekst i granice wraz z wyrenderowanym obrazem.

Przykłady

Wyrenderuj HotelDetailScreenPreview do preview_hotel.png i wydrukuj drzewo semantyczne:

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