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

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

قد تبدأ التطبيقات التي تستخدم هذه الطرق في الإصدارات المتأثرة من حزمة تطوير البرامج (SDK) لـ ARCore بالانطباق على سلوك مختلف أو تتعطل عندما يُحدِّث المستخدمون "خدمات 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 من حزمة ARCore SDK أو إصدار أحدث.

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

يمكنك اختبار التطبيق من خلال محاكاة التغييرات التي أُجريت في تشرين الثاني (نوفمبر) 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.