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