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