يُجدِّد Android 12 (المستوى 31 من واجهة برمجة التطبيقات) واجهة برمجة التطبيقات الخاصة بالأدوات الحالية لتحسين تجربة المستخدم والمطوّر في النظام الأساسي ومشغّلات التطبيقات. استخدِم هذا الدليل لمعرفة كيفية التأكّد من توافق التطبيق المصغّر مع Android 12، ويمكنك أيضًا استخدامه كمرجع لواجهات برمجة التطبيقات لتحديث التطبيق المصغّر الحالي.
التأكّد من توافق التطبيق المصغّر مع Android 12
تتضمّن التطبيقات المصغّرة في 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 تحسين تجربة أداة اختيار التطبيقات المصغّرة لتطبيقك من خلال إضافة معاينات ديناميكية وأوصاف للتطبيقات المصغّرة. لمزيد من التفاصيل، يُرجى الاطّلاع على إضافة معاينات قابلة للتكيّف للتطبيقات المصغّرة إلى أداة اختيار التطبيقات المصغّرة وإضافة وصف للتطبيق المصغّر.
تفعيل الانتقالات الأكثر سلاسة
بدءًا من الإصدار 12 من نظام التشغيل Android، توفّر مشغّلات التطبيقات انتقالاً أكثر سلاسة عندما يشغّل المستخدم تطبيقك من تطبيق مصغّر. يُرجى الاطّلاع على تفعيل الانتقالات الأكثر سلاسة لمزيد من التفاصيل.
استخدام مجموعات RemoteViews المبسّطة
يضيف Android 12 طريقة
setRemoteAdapter(int viewId, RemoteViews.RemoteCollectionItems items)
التي تتيح لتطبيقك تمرير مجموعة مباشرةً عند تعبئة
ListView. في السابق، عند استخدام
ListView، كان من الضروري تنفيذ
RemoteViewsService والإعلان عنه لعرض
RemoteViewsFactory.
لمعرفة التفاصيل، يُرجى الاطّلاع على استخدام مجموعات "RemoteViews".
استخدام تعديل وقت التشغيل لـ RemoteViews
يضيف Android 12 عدة طرق RemoteViews تتيح تعديل سمات RemoteViews أثناء التشغيل. يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات RemoteViews للحصول على القائمة الكاملة بالطرق المُضافة.
لمعرفة التفاصيل، يُرجى الاطّلاع على استخدام تعديل وقت التشغيل في
RemoteViews.