يجدّد Android 12 (المستوى 31 من واجهة برمجة التطبيقات) واجهة برمجة تطبيقات التطبيقات المصغّرة الحالية لتحسين تجربة المستخدم والمطوّر في النظام الأساسي ومشغّلات التطبيقات. يمكنك استخدام هذا الدليل لمعرفة كيفية التأكّد من توافق التطبيق المصغّر مع نظام Android 12، كما يمكنك استخدامه كمرجع لواجهات برمجة التطبيقات لإعادة تحميل التطبيق المصغّر الحالي.
التأكّد من توافق التطبيق المصغّر مع الإصدار 12 من نظام التشغيل Android
تتميّز التطبيقات المصغّرة في Android 12 بزوايا مستديرة. عند استخدام تطبيق مصغّر على جهاز يعمل بالإصدار 12 من نظام التشغيل Android أو إصدار أحدث، يحدّد مشغّل التطبيقات تلقائيًا خلفية التطبيق المصغّر ويقتصه إلى زوايا مستديرة.
في هذه الحالة، قد لا يتم عرض الأداة بشكل صحيح في أي من الشروط التالية:
احتواء الأداة على محتوى في الزوايا: قد يؤدي ذلك إلى اقتصاص بعض المحتوى في منطقة الزاوية.
يستخدم التطبيق المصغّر خلفية غير قابلة للاقتصاص. ويشمل ذلك خلفية شفافة أو طرق عرض أو تنسيقات فارغة أو أي نوع آخر من الخلفية الخاصة غير المعرضة للاقتصاص. قد لا يتمكن النظام من تحديد الخلفية لاستخدامها بشكل صحيح.
إذا كان هذا التغيير سيؤثر في التطبيق المصغَّر، نقترح إعادة تحميله بزوايا مستديرة (كما هو موضح في القسم التالي) لضمان عرضه بشكل صحيح.
استخدام العيّنة
لرؤية جميع واجهات برمجة التطبيقات هذه قيد التشغيل، اطّلع على أداة قائمة النماذج.
تنفيذ الزوايا المستديرة
يقدّم 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.