android studio render-compose-preview

Affiche un aperçu Compose dans Android Studio.

Utilisation

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

Options

  • -h,--help : affiche le message d'aide pour la commande spécifiée.
  • --output-image-file=PARAM : nom du fichier dans lequel écrire l'image obtenue.
  • --pid=PARAM : PID de l'instance Android Studio à laquelle se connecter.
  • --print-semantics : si la valeur est true, affiche l'arborescence sémantique.
  • --project=PARAM : nom ou chemin d'accès du projet ouvert dans Android Studio à interroger. Utilisez android studio check pour obtenir les noms des projets disponibles.

Options android :

  • --sdk=PARAM : chemin d'accès au SDK Android.
  • -v,--verbose : active la sortie détaillée pour le dépannage.
  • -V,--version : imprime les informations sur la version et quitte.

Arguments positionnels

  • <path> : chemin d'accès au fichier contenant l'aperçu Compose, relatif au répertoire actuel ou absolu.
  • <composable> : nom du composable.

Description

android studio render-compose-preview affiche une fonction @Preview Jetpack Compose à l'aide du moteur de rendu de mise en page d'Android Studio et imprime éventuellement son arbre sémantique d'accessibilité.

Nécessite Android Studio Quail 2 ou version ultérieure.

Configurer l'aperçu (--output-image-file et --print-semantics)

  • --output-image-file : enregistre l'aperçu PNG affiché dans le chemin d'accès au fichier spécifié. Si cette option est omise, un fichier PNG temporaire est créé.
  • --print-semantics : affiche l'arborescence sémantique d'accessibilité de l'aperçu Compose au format JSON afin que les agents d'IA puissent inspecter les nœuds interactifs, le texte et les limites en même temps que l'image visuelle rendue.

Exemples

Affichez HotelDetailScreenPreview sur preview_hotel.png et imprimez son arborescence sémantique :

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