Android 스튜디오 render-compose-preview

Android 스튜디오에서 Compose 미리보기를 렌더링합니다.

사용

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

옵션

  • -h,--help - 지정된 명령어의 도움말 메시지를 표시합니다.
  • --output-image-file=PARAM - 결과 이미지를 쓸 파일 이름입니다.
  • --pid=PARAM - 연결할 Android 스튜디오 인스턴스의 PID입니다.
  • --print-semantics - true인 경우 시맨틱 트리를 출력합니다.
  • --project=PARAM - Android 스튜디오에서 열려 있는 프로젝트의 이름 또는 경로입니다. android studio check를 사용하여 사용 가능한 프로젝트의 이름을 가져옵니다.

android 옵션:

  • --sdk=PARAM - Android SDK의 경로
  • -v,--verbose - 문제 해결을 위해 상세 출력을 사용 설정합니다.
  • -V,--version - 버전 정보를 인쇄하고 종료합니다.

위치 인수

  • <path> - 현재 디렉터리를 기준으로 하는 Compose 미리보기 파일의 경로(상대 또는 절대)
  • <composable> - 컴포저블의 이름입니다.

설명

android studio render-compose-preview는 Android 스튜디오의 레이아웃 렌더링 엔진을 사용하여 Jetpack Compose @Preview 함수를 렌더링하고 선택적으로 접근성 시맨틱 트리도 출력합니다.

Android 스튜디오 Quail 2 이상이 필요합니다.

미리보기 출력 구성 (--output-image-file 및 --print-semantics)

  • --output-image-file: 렌더링된 PNG 미리보기를 지정된 파일 경로에 저장합니다. 생략하면 임시 PNG 파일이 생성됩니다.
  • --print-semantics: AI 에이전트가 렌더링된 시각적 이미지와 함께 대화형 노드, 텍스트, 경계를 검사할 수 있도록 Compose 미리보기의 접근성 시맨틱 트리(semantics tree)를 JSON 형식으로 출력합니다.

예

HotelDetailScreenPreview를 preview_hotel.png로 렌더링하고 시맨틱 트리를 출력합니다.

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