تشرين الثاني (نوفمبر) 2022 تم إيقاف العمل بأساليب إزالة الكاميرا من أجل حزمة SDK ARCore لنظام التشغيل Android (Kotlin/Java)

في تشرين الثاني (نوفمبر) 2022، ستزيل "خدمات Google Play للواقع المعزّز" الطرق المتوقّفة نهائيًا المرتبطة بصور الكاميرا والبيانات الوصفية في حزمة تطوير البرامج (NDK).

التطبيقات التي تستخدم هذه الطرق في الإصدارات المتأثرة من حزمة ARCore SDK قد تبدأ في بشكل مختلف أو يتعطّل عندما يحدِّث المستخدمون "خدمات Google Play للواقع المعزّز".

التطبيقات المتأثّرة

اعتبارًا من تشرين الثاني (نوفمبر) 2022، قد يتوقّف تطبيقك عن العمل أو يتعطّل عند تحديث المستخدمين. إلى أحدث إصدار من خدمات Google Play للواقع المعزّز في الحالات التالية:

1. تم تجميع تطبيقك باستخدام حزمة تطوير برامج (SDK) متأثرة
2. يستخدم تطبيقك أيًا من واجهات برمجة التطبيقات المتأثّرة التالية:

إذا تم تجميع تطبيقك باستخدام إصدار حزمة تطوير البرامج (SDK) من ARCore…	وتستخدم واجهات برمجة التطبيقات المتأثرة…	إيقاف السلوك نهائيًا اعتبارًا من تشرين الثاني (نوفمبر) 2022
1.19.0 أو أقل	Frame.getImageMetadata()	الرميات IllegalArgumentException
1.10.0 أو إصدار أقل	Frame.acquireCameraImage()	لعرض صورة بحجم 0×0.

إصلاح التطبيقات المتأثّرة

قد تحدث أعطال في التطبيقات المتأثّرة في تشرين الثاني (نوفمبر) 2022. للحدّ من هذه المشكلة، أعِد إنشاء تطبيقك باستخدام أحدث إصدار من حزمة تطوير البرامج (SDK) لـ ARCore. على الأقل، يجب الترقية إلى الإصدار 1.20.0 من حزمة تطوير البرامج (SDK) لـ ARCore أو إصدار أحدث.

التأكّد من حلّ المشكلة في التطبيق المتأثّر

يمكنك اختبار التطبيق من خلال محاكاة تغييرات تشرين الثاني (نوفمبر) 2022 مسبقًا عن طريق إضافة إدخال meta-data خاص إلى AndroidManifest.xml تطبيقك:

1. تأكّد من تثبيت الإصدار 1.29.0 أو الإصدارات الأحدث من خدمات Play للواقع المعزّز على الجهاز المستهدَف.

2. أضِف علامة <meta-data> جديدة كعنصر فرعي للعنصر <application> الحالي في ملف AndroidManifest.xml الخاص بالتطبيق :

   <application …>
     …
   
     <!--
          Simulate the November 2022 changes in advance.
          IMPORTANT: Remove this tag when testing is completed.
          Do not include this tag in published versions of your app.
     -->
     <meta-data android:name="com.google.ar.core.session_settings"
                android:value="camera_stack_option,unified_mono" />
   </application>
   

3. اختبِر تطبيقك وتأكَّد من أنّ جميع ميزات ARCore تعمل متوقع.

4. أزِل العلامة <meta-data> عند اكتمال الاختبار. جارٍ ترك هذه العلامة في تطبيقك المنشور إلى سلوك غير متوقع المستقبلية.

إذا كان التطبيق يعمل بشكل طبيعي، سيكون التطبيق جاهزًا للتغييرات في تشرين الثاني (نوفمبر) 2022.

المخطط الزمني

نقطة	الفعاليات
تشرين الثاني (نوفمبر) 2020 (الإصدار 1.20.0 من حزمة تطوير البرامج (SDK) لتطبيق ARCore)	إيقاف واجهات برمجة التطبيقات الأصلية نهائيًا عدِّل عملية التنفيذ لاستخدام واجهات برمجة تطبيقات أصلية بديلة.
تشرين الثاني (نوفمبر) 2021	الإعلان عن تغيير مستقبلي ناتج عن الإزالة المعلّقة لتطبيق واجهات برمجة التطبيقات المتأثرة من "خدمات Google Play للواقع المعزّز" في تشرين الثاني (نوفمبر) 2022
تشرين الثاني (نوفمبر) 2022	إزالة تنفيذ واجهات برمجة التطبيقات المتأثرة من "خدمات Google Play للواقع المعزّز" إدخال تغيير قد يؤدي إلى أعطال في التطبيقات التي تستخدم إصدارات ARCore قبل 1.20.0.