يُعيد الإصدار 12 من Android (المستوى 31 من واجهة برمجة التطبيقات) تنظيم واجهة برمجة التطبيقات لتطبيقات المصغّرة الحالية لتحسين تجربتَي المستخدم والمطوّر في النظام الأساسي ومشغّلات التطبيقات. يمكنك استخدام هذا الدليل لمعرفة كيفية التأكّد من توافق التطبيق المصغّر مع نظام Android 12، كما يمكنك استخدامه كمرجع لواجهات برمجة التطبيقات لإعادة تحميل التطبيق المصغّر الحالي.
التأكّد من توافق التطبيق المصغّر مع الإصدار 12 من نظام التشغيل Android
تتضمّن التطبيقات المصغّرة في Android 12 زوايا دائرية. عند استخدام تطبيق مصغّر على جهاز يعمل بنظام التشغيل Android 12 أو إصدار أحدث، يرصد المشغّل تلقائيًا خلفية التطبيق المصغّر ويقطعها لتكون لها زوايا مستديرة.
في هذه الحالة، قد لا يتم عرض الأداة بشكل صحيح في أي من الشروط التالية:
تحتوي الأداة المصغّرة على محتوى في الزوايا: قد يؤدي ذلك إلى اقتصاص بعض المحتوى في منطقة الزاوية.
يستخدم التطبيق المصغّر خلفية لا يمكن اقتصاصها. ويشمل ذلك الخلفية الشفافة أو طرق العرض أو التنسيقات الفارغة أو أي نوع آخر من الخلفيات الخاصة غير المعرضة للاقتصاص. قد لا يتمكن النظام من تحديد الخلفية لاستخدامها بشكل صحيح.
إذا كان تطبيقك المصغّر سيتأثّر بهذا التغيير، ننصحك بتعديله باستخدام زوايا مستديرة (كما هو موضّح في القسم التالي) لضمان عرضه بشكل صحيح.
استخدام العيّنة
للاطّلاع على جميع واجهات برمجة التطبيقات هذه أثناء استخدامها، يمكنك الاطّلاع على تطبيق مصغّر لقائمة النماذج.
تنفيذ زوايا مستديرة
يقدّم نظام التشغيل Android 12 مَعلمتَي النظام system_app_widget_background_radius
وsystem_app_widget_inner_radius
لضبط أقطار الزوايا المستديرة للتطبيق المصغّر.
1 زاوية التطبيق المصغّر
2 زاوية عرض داخل التطبيق المصغّر
لمعرفة التفاصيل، يُرجى الاطّلاع على تطبيق الزوايا المستديرة.
إضافة مظهر الجهاز
بدءًا من الإصدار 12 من نظام Android، يمكن للتطبيق المصغّر استخدام ألوان مظهر الجهاز للأزرار والخلفيات والمكوّنات الأخرى، بما في ذلك المظهر الفاتح والداكن. يتيح ذلك الانتقالات السلسة والاتساق في التطبيقات المصغّرة المختلفة.
اطّلِع على إضافة مظهر الجهاز للحصول على مزيد من المعلومات.
تسهيل تخصيص التطبيقات المصغّرة
إذا حدّدت نشاطًا لضبط التطبيق باستخدام السمة configure لملف appwidget-provider،
يبدأ مضيف التطبيق المصغّر هذا النشاط على الفور بعد أن يضيف المستخدم التطبيق المصغّر إلى شاشة منزله.
يضيف نظام التشغيل Android 12 خيارات جديدة تتيح لك تقديم تجربة أفضل لناحية الضبط للمستخدمين. اطّلِع على السماح للمستخدمين بضبط تطبيقات المصغّرة لمعرفة التفاصيل.
إضافة أزرار مركّبة جديدة
يضيف Android 12 ميزة جديدة تتيح السلوك المستند إلى الحالة باستخدام المكوّنات الحالية التالية:
لا تزال الأداة بلا حالة. يجب أن يخزّن تطبيقك الولاية ويسجّل أحداث التغيير في الولاية.
لمعرفة التفاصيل، يُرجى الاطِّلاع على دعم السلوك المتعلّق بحالات محددة.
استخدام واجهات برمجة تطبيقات محسّنة لتنسيقات وأشكال التطبيقات المصغّرة
بدءًا من الإصدار 12 من نظام Android، يمكنك الاستفادة من سمات حجم أكثر دقة وتصميمات أكثر مرونة، وذلك من خلال تحديد قيود إضافية لحجم التطبيقات المصغّرة وتوفير تصميمات متجاوبة وتصميمات دقيقة.
راجِع توفير تنسيقات مرنة للتطبيقات المصغّرة للاطّلاع على التفاصيل.
تحسين تجربة اختيار التطبيقات المصغّرة في تطبيقك
يتيح لك نظام التشغيل Android 12 تحسين تجربة أداة اختيار التطبيقات المصغّرة لتطبيقك من خلال إضافة معاينات ديناميكية للتطبيقات المصغّرة وأوصاف لها. للاطّلاع على التفاصيل، يُرجى الاطّلاع على مقالتَي إضافة معاينات أدوات قابلة للتكبير/التصغير إلى أداة اختيار التطبيقات المصغّرة وإضافة وصف لتطبيقك المصغّر.
تفعيل عمليات النقل بسلاسة أكبر
اعتبارًا من Android 12، يوفّر مشغّلو التطبيقات انتقالًا أكثر سلاسة عندما يشغّل المستخدم تطبيقك من تطبيق مصغّر. راجِع مقالة تفعيل التحولات بشكل أكثر سلاسة للاطّلاع على التفاصيل.
استخدام مجموعات RemoteViews المبسّطة
يضيف Android 12 الطريقة
setRemoteAdapter(int viewId, RemoteViews.RemoteCollectionItems items)
التي تتيح لتطبيقك نقل مجموعة مباشرةً عند تعبئة
ListView. في السابق، عند استخدام
ListView، كان من الضروري تنفيذ
RemoteViewsService وتعريفه لعرض
RemoteViewsFactory.
لمعرفة التفاصيل، يُرجى الاطّلاع على استخدام مجموعات RemoteViews.
استخدام تعديل وقت التشغيل من RemoteViews
يضيف نظام التشغيل Android 12 عدة طرق RemoteViews تتيح تعديل سمات RemoteViews أثناء التشغيل. يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات RemoteViews
للحصول على القائمة الكاملة بالطرق المضافة.
لمعرفة التفاصيل، يُرجى الاطّلاع على استخدام تعديل بيئة التشغيل
RemoteViews.