android studio render-compose-preview

Esegue il rendering di un'anteprima di Compose in Android Studio.

Utilizzo

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

Opzioni

  • -h,--help - Mostra il messaggio di aiuto per il comando specificato.
  • --output-image-file=PARAM: il nome del file in cui scrivere l'immagine risultante.
  • --pid=PARAM: il PID dell'istanza di Android Studio a cui connettersi.
  • --print-semantics: se true, stampa l'albero semantico.
  • --project=PARAM: il nome o il percorso del progetto aperto in Android Studio da interrogare. Utilizza android studio check per ottenere i nomi dei progetti disponibili.

android opzioni:

  • --sdk=PARAM: percorso dell'SDK Android.
  • -v,--verbose - Enable verbose output for troubleshooting.
  • -V,--version - Stampa le informazioni sulla versione ed esci.

Argomenti posizionali

  • <path> - Il percorso del file contenente l'anteprima di Composizione, relativo alla directory corrente o assoluto.
  • <composable> - Il nome del componente componibile.

Descrizione

android studio render-compose-preview esegue il rendering di una funzione @Preview di Jetpack Compose utilizzando il motore di rendering del layout di Android Studio e, facoltativamente, stampa l'albero semantico di accessibilità.

Richiede Android Studio Quail 2 o versioni successive.

Configurare l'output di anteprima (--output-image-file e --print-semantics)

  • --output-image-file: salva l'anteprima PNG sottoposta a rendering nel percorso del file specificato. Se omesso, viene creato un file PNG temporaneo.
  • --print-semantics: stampa l'albero semantico di accessibilità dell'anteprima di Compose in formato JSON in modo che gli agenti AI possano esaminare nodi interattivi, testo e limiti insieme all'immagine visiva sottoposta a rendering.

Esempi

Esegui il rendering di HotelDetailScreenPreview in preview_hotel.png e stampa il relativo albero semantico:

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