عمليات الإيقاف نهائيًا

مع كل إصدار، قد تصبح واجهات برمجة تطبيقات Android معيّنة قديمة أو قد تحتاج إلى إعادة هيكلة لتوفير تجربة أفضل للمطوّرين أو إتاحة ميزات جديدة في النظام الأساسي. وفي هذه الحالات، سيوقف Android رسميًا استخدام واجهات برمجة التطبيقات القديمة ويوجّه المطوّرين إلى استخدام واجهات برمجة التطبيقات الجديدة بدلاً منها.

يعني إيقاف الاستخدام نهائيًا أنّنا أوقفنا رسميًا دعم واجهات برمجة التطبيقات، ولكن ستظل متاحة للمطوّرين. تُبرز هذه الصفحة بعضًا من ميزات Android التي سيتم إيقافها نهائيًا في هذا الإصدار. للاطّلاع على عمليات الإيقاف النهائي الأخرى، يُرجى الرجوع إلى تقرير اختلافات واجهة برمجة التطبيقات.

RenderScript

اعتبارًا من Android 12، تم إيقاف واجهات برمجة التطبيقات RenderScript نهائيًا. وسيظلّ مفعولها قائمًا، ولكننا نتوقع أن يتوقف مصنعو الأجهزة والمكوّنات عن توفير ميزة "تسريع الأجهزة" بمرور الوقت. للاستفادة بشكل كامل من ميزة تسريع وحدة معالجة الرسومات، ننصحك بإيقاف استخدام RenderScript.

قوائم تشغيل Android

تمّت إيقاف قوائم التشغيل على Android نهائيًا. لم تعُد واجهة برمجة التطبيقات قيد الصيانة، ولكن ستبقى الوظيفة الحالية متوافقة مع الأنظمة القديمة.

ننصحك بقراءة قوائم التشغيل وحفظها كملفات m3u.

إيقاف Display API نهائيًا

أصبحت أجهزة Android متاحة بأشكال مختلفة، مثل الشاشات الكبيرة والأجهزة اللوحية والأجهزة القابلة للطي. لعرض المحتوى بشكلٍ مناسب على كل جهاز، يجب أن يحدِّد تطبيقك حجم الشاشة أو شاشة العرض. على مدار الوقت، قدّم نظام التشغيل Android واجهات برمجة تطبيقات مختلفة لاسترداد هذه المعلومات. في Android 11، قدمنا واجهة برمجة التطبيقات WindowMetrics وأوقفنا نهائيًا هذه الطرق:

• Display.getSize()
• Display.getMetrics()

في Android 12، ما زلنا نقترح استخدام WindowMetrics ونعمل على إيقاف الطريقتَين التاليتَين نهائيًا:

• Display.getRealSize()
• Display.getRealMetrics()

يجب أن تستخدم التطبيقات واجهات برمجة تطبيقات WindowMetrics للاستعلام عن حدود نافذتها، أو Configuration.densityDpi للاستعلام عن الكثافة الحالية.

تجدر الإشارة إلى أنّ مكتبة WindowManager Jetpack تتضمّن فئة WindowMetrics تتوافق مع الإصدار 4.0.1 من نظام التشغيل Android (المستوى 14 من واجهة برمجة التطبيقات) والإصدارات الأحدث.

أمثلة

في ما يلي بعض الأمثلة على كيفية استخدام WindowMetrics.

أولاً، تأكَّد من أنّ تطبيقك يمكنه جعل الأنشطة قابلة للتغيير حجمها بالكامل.

يجب أن يعتمد النشاط على WindowMetrics من سياق النشاط للقيام بأي عمل متعلق بواجهة المستخدم، خاصةً WindowManager.getCurrentWindowMetrics().

إذا كان تطبيقك ينشئ MediaProjection، يجب ضبط حدوده بشكل صحيح لأنّ الإسقاط يُسجّل الشاشة. إذا كان التطبيق قابلاً للتغيير بالكامل، يعرض سياق النشاط الحدود الصحيحة.

val projectionMetrics = activityContext
        .getSystemService(WindowManager::class.java).maximumWindowMetrics

WindowMetrics projectionMetrics = activityContext
        .getSystemService(WindowManager.class).getMaximumWindowMetrics();

إذا لم يكن بالإمكان تغيير حجم التطبيق بالكامل، يجب أن يطلب التطبيق الحدود من مثيل WindowContext، واسترداد WindowMetrics لأكبر مساحة شاشة متاحة للتطبيق باستخدام WindowManager.getMaximumWindowMetrics()

val windowContext = context.createWindowContext(mContext.display!!,
      WindowManager.LayoutParams.TYPE_APPLICATION, null)
val projectionMetrics = windowContext.getSystemService(WindowManager::class.java)
      .maximumWindowMetrics

Context windowContext = mContext.createWindowContext(mContext.getDisplay(),
      WindowManager.LayoutParams.TYPE_APPLICATION, null;
WindowMetrics projectionMetrics = windowContext.getWindowManager()
      .getMaximumWindowMetrics();