android studio render-compose-preview

แสดงตัวอย่าง Compose ใน Android Studio

การใช้งาน

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 - PID ของอินสแตนซ์ Android Studio ที่จะเชื่อมต่อ
  • --print-semantics - If true, prints out the semantics tree.
  • --project=PARAM - ชื่อหรือเส้นทางของโปรเจ็กต์ที่เปิดใน Android Studio เพื่อทำการค้นหา ใช้ android studio check เพื่อดูชื่อโปรเจ็กต์ที่พร้อมใช้งาน

android ตัวเลือก

  • --sdk=PARAM - เส้นทางไปยัง Android SDK
  • -v,--verbose - เปิดใช้เอาต์พุตแบบละเอียดเพื่อการแก้ปัญหา
  • -V,--version - พิมพ์ข้อมูลเวอร์ชันและออก

อาร์กิวเมนต์ตามตำแหน่ง

  • <path> - เส้นทางของไฟล์ที่มีตัวอย่างการเขียน ซึ่งสัมพันธ์กับไดเรกทอรีปัจจุบันหรือสัมบูรณ์
  • <composable> - ชื่อของ Composable

คำอธิบาย

android studio render-compose-preview แสดงฟังก์ชัน @Preview ของ Jetpack Compose โดยใช้เครื่องมือการแสดงผลเลย์เอาต์ของ Android Studio และจะพิมพ์แผนผัง Semantics ของการช่วยเหลือพิเศษหรือไม่ก็ได้

ต้องใช้ Android Studio Quail 2 ขึ้นไป

กำหนดค่าเอาต์พุตตัวอย่าง (--output-image-file และ --print-semantics)

  • --output-image-file: บันทึกตัวอย่าง PNG ที่แสดงผลไปยังเส้นทางไฟล์ที่ระบุ หากไม่ระบุ ระบบจะสร้างไฟล์ PNG ชั่วคราว
  • --print-semantics: พิมพ์แผนผังความหมายของการช่วยเหลือพิเศษของตัวอย่าง Compose ในรูปแบบ JSON เพื่อให้ตัวแทน AI ตรวจสอบโหนดแบบอินเทอร์แอกทีฟ ข้อความ และขอบเขตควบคู่ไปกับรูปภาพที่แสดง

ตัวอย่าง

แสดงผล 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