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