رندر-نوشتن-پیش‌نمایش در اندروید استودیو

پیش‌نمایشی از 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 - PID نمونه اندروید استودیو که قرار است به آن متصل شوید.
  • --print-semantics - اگر true ، درخت معنایی را چاپ می‌کند.
  • --project=PARAM - نام یا مسیر پروژه‌ای که در اندروید استودیو برای جستجو باز است. android studio check برای دریافت نام پروژه‌های موجود استفاده کنید.

گزینه‌های android :

  • --sdk=PARAM - مسیر به SDK اندروید.
  • -v,--verbose - خروجی verbose را برای عیب‌یابی فعال کنید.
  • -V,--version - اطلاعات نسخه را چاپ کرده و خارج شوید.

استدلال‌های موضعی

  • <path> - مسیر فایل حاوی پیش‌نمایش Compose، نسبت به دایرکتوری فعلی یا مطلق.
  • <composable> - نام عنصر قابل ترکیب.

توضیحات

android studio render-compose-preview یک تابع Jetpack Compose @Preview را با استفاده از موتور رندر طرح‌بندی اندروید استودیو رندر می‌کند و به صورت اختیاری درخت معنایی دسترسی‌پذیری آن را چاپ می‌کند.

به اندروید استودیو Quail 2 یا بالاتر نیاز دارد.

پیکربندی پیش‌نمایش خروجی ( --output-image-file و --print-semantics )

  • --output-image-file : پیش‌نمایش PNG رندر شده را در مسیر فایل مشخص شده ذخیره می‌کند. در صورت حذف، یک فایل PNG موقت ایجاد می‌شود.
  • --print-semantics : درخت معنایی دسترسی‌پذیری پیش‌نمایش Compose را با فرمت 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