android studio render-compose-preview

تعرض هذه السمة معاينة لـ Compose في "استوديو Android".

الاستخدام

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" الذي تريد الاتصال به.
  • --print-semantics: إذا كانت القيمة true، تتم طباعة شجرة الترميز الدلالي.
  • --project=PARAM: اسم المشروع أو مساره المفتوح في "استوديو Android" لتنفيذ طلب البحث. استخدِم android studio check للحصول على أسماء المشاريع المتاحة.

خيارات android:

  • استبدِل --sdk=PARAM بمسار حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
  • -v,--verbose: لتفعيل الإخراج المطوَّل لتحديد المشاكل وحلّها
  • ‫-V,--version - طباعة معلومات الإصدار والخروج

الوسيطات الموضعية

  • ‫<path> - مسار الملف الذي يحتوي على معاينة Compose، وهو مسار نسبي إلى الدليل الحالي أو مسار مطلق.
  • <composable> - اسم الدالة المركّبة.

الوصف

تعرض الدالة android studio render-compose-preview دالة @Preview في Jetpack Compose باستخدام محرّك عرض التنسيق في "استوديو Android"، ويمكنها أيضًا طباعة شجرة دلالات تسهيل الاستخدام.

يتطلّب الإصدار 2 أو إصدارًا أحدث من Android Studio Quail.

ضبط مخرجات المعاينة (--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