إرشادات AEP: الجودة - Jetpack Compose

استخدِم Jetpack Compose لإنشاء واجهة المستخدم. ‫Jetpack Compose هي مجموعة أدوات واجهة المستخدم المفضّلة لتطوير تطبيقات Android. وهي توفّر الطريقة الأكثر مباشرةً لاستيفاء معايير البرنامج وإنشاء تجارب Android عالية الجودة من خلال دعم التصميم المتعدد الأبعاد الأصلي والتكامل السلس مع النظام والتوسيع المبسّط لمختلف أشكال الأجهزة.

التنفيذ المطلوب

للتأهّل للانضمام إلى "برنامج تجربة Android المميّزة"، يجب أن تستخدم التطبيقات Jetpack Compose أو بديلاً مكافئًا لإنشاء واجهة المستخدم.

على الرغم من أنّ Compose هو المعيار المفضّل، يمكنك استخدام مجموعات أدوات بديلة إذا كانت توفّر أداءً ووظائف مكافئة. ‫React Native هي مجموعة أدوات بديلة معتمَدة، ولكن قد تتغيّر قائمة مجموعات الأدوات المعتمَدة مع تطوّر نظام Jetpack الأساسي. يمكن إضافة مجموعات الأدوات إلى القائمة أو إزالتها منها استنادًا إلى مدى التزامها بأحدث المعايير.

تسمح هذه الإرشادات بالاستخدام الإضافي لمجموعات أدوات أخرى، مثل Flutter أو Android Views أو WebView، إلى جانب Jetpack Compose أو البدائل الأخرى المقبولة. على الرغم من أنّ المعايير الحالية تسمح بهذه المرونة، قد تفرض تحديثات البرنامج المستقبلية عتبات أعلى للاستخدام استنادًا إلى النسبة المئوية لأنشطة التطبيق أو مكوّنات واجهة المستخدم التي تم إنشاؤها باستخدام Compose. كما هو الحال مع جميع تحديثات متطلبات البرنامج، سيتم إرسال إشعار كافٍ إلى المطوّرين قبل تعديل هذه العتبات.

مدى تطبيق الإرشادات

تنطبق هذه الإرشادات على جميع التطبيقات على جميع أشكال الأجهزة.

الإعفاءات

يمكنك إرسال مجموعات أدوات بديلة لتقييمها إذا كنت تعتقد أنّه يجب أخذها في الاعتبار إلى جانب مجموعات الأدوات البديلة المقبولة. للتأهّل، يجب أن تستوفي مجموعة الأدوات المعايير التالية:

  1. الأداء
    1. تحقيق وقت العرض الأوّلي أقل من 400 ملي ثانية باستخدام التجميع المسبق أو التحسينات المكافئة
    2. عرض واجهة المستخدم بمعدّل التحديث الأصلي للجهاز بدون فقدان أي إطار
  2. نماذج واجهة مستخدم Android العادية
    1. توفير رسوم متحركة للاستجابة للمس لجميع تفاعلات العناصر
    2. توفير تصميم من الحافة إلى الحافة من خلال الرسم خلف أشرطة النظام والتعامل مع مساحات العرض الداخلية للنافذة
    3. توفير تأثيرات التمدّد عند التمرير الزائد overscroll عند حدود التمرير
    4. الاستجابة تلقائيًا لعمليات تبديل المظهر الفاتح والداكن في النظام بدون إعادة تشغيل التطبيق
    5. تطبيق واجهات برمجة تطبيقات لوحة الألوان على مستوى الجهاز لتعديل رموز واجهة المستخدم ديناميكيًا باستخدام دعم التصميم المتعدد الأبعاد
  3. دعم الميزات المساعدة
    1. التكامل مع إطار تسهيل استخدام Android، بما في ذلك قارئ الشاشة ودعم TalkBack
    2. دعم إطار الملء التلقائي في Android لإدخال بيانات المستخدم بطريقة مبسطة
    3. التكامل مع خدمات الذكاء على مستوى النظام لتسجيل نشاط التطبيق في الوقت الفعلي
  4. وضع النوافذ المتعدّدة والطي والقدرة على التكيّف
    1. تغيير حجم حدود واجهة المستخدم في منتصف الجلسة على مستوى فئات أحجام النوافذ بدون إعادة تشغيل الحاوية
    2. الاحتفاظ بحالات الجلسة النشطة، مثل تشغيل الفيديو أو إدخال البيانات في النموذج، أثناء الطي أو تغيير الحجم في منتصف الجلسة

مستندات الميزات والمراجع

توفّر المراجع التالية إرشادات التنفيذ والتفاصيل الفنية بشأن ميزة Jetpack Compose. هذه المراجع هي للاطلاع فقط ولا تتضمّن متطلبات إضافية للبرنامج.