تحسينات على تطبيقات Android 12 المصغّرة

يُعيد الإصدار 12 من Android (المستوى 31 من واجهة برمجة التطبيقات) تنظيم واجهة برمجة التطبيقات لتطبيقات المصغّرة الحالية لتحسين تجربتَي المستخدم والمطوّر في النظام الأساسي ومشغّلات التطبيقات. يمكنك الاطّلاع على هذا الدليل للتعرّف على كيفية التأكّد من توافق التطبيق المصغّر مع Android 12، ويمكنك أيضًا الرجوع إليه كدليل لواجهات برمجة التطبيقات من أجل تحديث التطبيق المصغّر الحالي.

نص بديل

التأكّد من توافق التطبيق المصغّر مع Android 12

تتضمّن التطبيقات المصغّرة في Android 12 زوايا دائرية. عند استخدام تطبيق مصغّر على جهاز يعمل بنظام التشغيل Android 12 أو إصدار أحدث، يرصد المشغّل تلقائيًا خلفية التطبيق المصغّر ويقطعها لتكون لها أطراف مستديرة.

في هذا السيناريو، قد لا يظهر التطبيق المصغّر بشكل صحيح في أيّ من الحالتين التاليتَين:

  • تحتوي الأداة المصغّرة على محتوى في الزوايا: قد يؤدي ذلك إلى اقتصاص بعض المحتوى في منطقة الزاوية.

  • يستخدم التطبيق المصغّر خلفية لا يمكن اقتصاصها. ويشمل ذلك الخلفية الشفافة أو طرق العرض أو التنسيقات الفارغة أو أي نوع آخر من الخلفيات الخاصة غير المعرضة للاقتصاص. قد لا يتمكّن النظام من تحديد الخلفية التي سيتم استخدامها بشكل صحيح.

إذا كان تطبيقك المصغّر سيتأثّر بهذا التغيير، ننصحك بتعديله باستخدام زوايا مستديرة (كما هو موضّح في القسم التالي) لضمان عرضه بشكل صحيح.

استخدام العيّنة

للاطّلاع على جميع واجهات برمجة التطبيقات هذه أثناء استخدامها، يمكنك الاطّلاع على تطبيق مصغّر لقائمة النماذج.

تنفيذ زوايا مستديرة

يقدّم نظام التشغيل Android 12 مَعلمتَي النظام system_app_widget_background_radius وsystem_app_widget_inner_radius لضبط أقطار الزوايا المستديرة للتطبيق المصغّر.

تطبيق الطقس المصغّر في طوكيو
الشكل 1: زوايا دائرية في تطبيق مصغّر وعرض داخل التطبيق المصغّر

1 زاوية التطبيق المصغّر

2 زاوية عرض داخل التطبيق المصغّر

لمعرفة التفاصيل، يُرجى الاطّلاع على تنفيذ الزوايا المستديرة.

إضافة مظهر الجهاز

بدءًا من الإصدار 12 من نظام Android، يمكن للتطبيق المصغّر استخدام ألوان مظهر الجهاز للأزرار والخلفيات والمكوّنات الأخرى، بما في ذلك المظهر الفاتح والداكن. ويتيح ذلك انتقالات أكثر سلاسة وتناسقًا بين التطبيقات المصغّرة المختلفة.

اطّلِع على إضافة مظهر الجهاز للحصول على مزيد من المعلومات.

مظهر التطبيق المصغّر في الوضع الفاتح
الشكل 2: التطبيق المصغّر في المظهر الفاتح
التطبيقات المصغّرة في مظهر "الوضع الداكن"
الشكل 3: التطبيق المصغّر في المظهر الداكن

تسهيل تخصيص التطبيقات المصغّرة

إذا حدّدت نشاطًا لضبط الإعدادات باستخدام السمة configure من appwidget-provider، يبدأ مضيف التطبيق المصغّر هذا النشاط مباشرةً بعد أن يضيف المستخدم التطبيق المصغّر إلى شاشته الرئيسية.

يضيف نظام التشغيل Android 12 خيارات جديدة تتيح لك تقديم تجربة أفضل لناحية الضبط للمستخدمين. اطّلِع على السماح للمستخدمين بضبط تطبيقات المصغّرة لمعرفة التفاصيل.

إضافة أزرار مركبة جديدة

يضيف Android 12 ميزة جديدة تتيح السلوك المستند إلى الحالة باستخدام المكوّنات الحالية التالية:

لا تزال الأداة لا تملك حالة. يجب أن يخزن تطبيقك الحالة وأن يسجّل أحداث تغيير الحالة.

الشكل 4: مثال على التطبيق المصغّر الذي يتضمّن مربّعات اختيار

لمعرفة التفاصيل، يُرجى الاطّلاع على التوافق مع السلوك المستند إلى الحالة.

استخدام واجهات برمجة تطبيقات محسّنة لتنسيقات وأشكال التطبيقات المصغّرة

بدءًا من الإصدار 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.