android studio render-compose-preview

Renderiza una vista previa de Compose en Android Studio.

Uso

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

Opciones

  • -h,--help: Muestra el mensaje de ayuda para el comando especificado.
  • --output-image-file=PARAM: Es el nombre del archivo en el que se escribirá la imagen resultante.
  • --pid=PARAM: Es el PID de la instancia de Android Studio a la que se conectará.
  • --print-semantics: Si es true, imprime el árbol semántico.
  • --project=PARAM: Es el nombre o la ruta de acceso del proyecto abierto en Android Studio para realizar la consulta. Usa android studio check para obtener los nombres de los proyectos disponibles.

Opciones de android:

  • --sdk=PARAM: Ruta de acceso al SDK de Android.
  • -v,--verbose: Habilita la salida detallada para la solución de problemas.
  • -V,--version: Imprime la información de la versión y sale.

Argumentos de posición

  • <path>: Es la ruta de acceso del archivo que contiene la vista previa de Compose, relativa al directorio actual o absoluta.
  • <composable>: Es el nombre del elemento componible.

Descripción

android studio render-compose-preview renderiza una función @Preview de Jetpack Compose con el motor de renderización de diseño de Android Studio y, de manera opcional, imprime su árbol de semántica de accesibilidad.

Se requiere Android Studio Quail 2 o una versión posterior.

Configura la salida de vista previa (--output-image-file y --print-semantics)

  • --output-image-file: Guarda la vista previa en PNG renderizada en la ruta de acceso al archivo especificada. Si se omite, se crea un archivo PNG temporal.
  • --print-semantics: Imprime el árbol semántico de accesibilidad de la vista previa de Compose en formato JSON para que los agentes de IA puedan inspeccionar los nodos interactivos, el texto y los límites junto con la imagen visual renderizada.

Ejemplos

Renderiza HotelDetailScreenPreview en preview_hotel.png y, luego, imprime su árbol semántico:

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