android studio render-compose-preview

Renderiza uma prévia do Compose no Android Studio.

Uso

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

Opções

  • -h,--help: mostra a mensagem de ajuda do comando especificado.
  • --output-image-file=PARAM: o nome do arquivo em que a imagem resultante será gravada.
  • --pid=PARAM: o PID da instância do Android Studio a ser conectada.
  • --print-semantics: se true, imprime a árvore semântica.
  • --project=PARAM: o nome ou caminho do projeto aberto no Android Studio para consulta. Use android studio check para acessar os nomes dos projetos disponíveis.

Opções de android:

  • --sdk=PARAM: caminho para o SDK do Android.
  • -v,--verbose - Ativa a saída detalhada para solução de problemas.
  • -V,--version: imprime informações da versão e sai.

Argumentos posicionais

  • <path>: o caminho do arquivo que contém a prévia do Compose, relativo ao diretório atual ou absoluto.
  • <composable> - O nome do elemento combinável.

Descrição

O android studio render-compose-preview renderiza uma função @Preview do Jetpack Compose usando o mecanismo de renderização de layout do Android Studio e, opcionalmente, imprime a árvore de semântica de acessibilidade.

Exige o Android Studio Quail 2 ou mais recente.

Configurar a saída de visualização (--output-image-file e --print-semantics)

  • --output-image-file: salva a prévia em PNG renderizada no caminho de arquivo especificado. Se omitido, um arquivo PNG temporário será criado.
  • --print-semantics: imprime a árvore semântica de acessibilidade da prévia do Compose no formato JSON para que os agentes de IA possam inspecionar nós interativos, texto e limites junto com a imagem visual renderizada.

Exemplos

Renderize HotelDetailScreenPreview para preview_hotel.png e imprima a árvore semântica:

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