नवंबर 2022 में, Android NDK (C) के लिए ARCore SDK टूल से जुड़े कैमरा के तरीकों को हटाने की सुविधा बंद कर दी गई है

Google Play Services for AR, नवंबर 2022 में NDK कैमरे की इमेज और मेटाडेटा से जुड़े, इस्तेमाल में न होने वाले तरीकों को हटा देगा.

जिन ऐप्लिकेशन में इन तरीकों का इस्तेमाल, ARCore SDK टूल के उन वर्शन में किया गया है जिन पर असर पड़ा है, वे अलग तरह से काम करने लग सकते हैं. इसके अलावा, जब उपयोगकर्ता Google Play Services for AR को अपडेट करेंगे, तो हो सकता है कि वे ऐप्लिकेशन क्रैश हो जाएं.

ऐसे ऐप्लिकेशन जिन पर इस समस्या का असर पड़ा

अहम जानकारी: ARCore SDK टूल के 1.23.0 या उसके बाद के वर्शन के साथ कंपाइल किए गए ऐप्लिकेशन पर इसका कोई असर नहीं पड़ेगा.

नवंबर 2022 से, जब उपयोगकर्ता Google Play Services for AR के नए वर्शन पर अपडेट करेंगे, तो हो सकता है कि आपका ऐप्लिकेशन काम करना बंद कर दे या क्रैश हो जाए. ऐसा तब होगा, जब:

1. आपके ऐप्लिकेशन को, समस्या वाले SDK टूल के साथ कंपाइल किया गया था
2. आपका ऐप्लिकेशन, इनमें से किसी भी एपीआई का इस्तेमाल करता है:

अगर आपके ऐप्लिकेशन को ARCore SDK टूल के वर्शन के साथ कंपाइल किया गया था…	और जिन एपीआई पर असर पड़ा है उनका इस्तेमाल करता है…	नवंबर 2022 से, ब्रेकिंग बिहेवियर की सुविधा बंद की जा रही है
1.22.0 या इससे पहले का वर्शन	ArImage_getNdkImage() (ARCore SDK 1.23.0 में हटाया गया)	नतीजे के AImage स्ट्रक्चर में NULL दिखाता है.
1.22.0 या इससे पहले का वर्शन	ArImage_getNdkCameraMetadata() (ARCore SDK 1.23.0 में हटाया गया)	नतीजे के ACameraMetadata स्ट्रक्चर में NULL दिखाता है.

जिन ऐप्लिकेशन पर असर पड़ा है उन्हें ठीक करना

जिन ऐप्लिकेशन पर असर पड़ा है उन्हें नवंबर 2022 में समस्याएं आ सकती हैं. इस समस्या को कम करने के लिए, जिन तरीकों पर असर पड़ा है उनके लिए ड्रॉप-इन रिप्लेसमेंट का इस्तेमाल करें:

• ArImage_getNdkImage() और AImage_* तरीके: ArImage में दिए गए उन तरीकों का इस्तेमाल करें. उदाहरण के लिए:
  • AImage_getNumberOfPlanes(), ArImage_getNumberOfPlanes() हो जाता है
  • AImage_getPlaneData(), ArImage_getPlaneData() हो जाता है
• ArImage_getNdkCameraMetadata(): इसके बजाय, ArImageMetadata_getConstEntry() का इस्तेमाल करें

पुष्टि करें कि जिस ऐप्लिकेशन पर असर पड़ा है उसे ठीक कर दिया गया है

अपने ऐप्लिकेशन के AndroidManifest.xml में कोई खास meta-data एंट्री जोड़कर, नवंबर 2022 में होने वाले बदलावों को पहले से ही सिम्युलेट करके, ऐप्लिकेशन की जांच करें:

1. पक्का करें कि टारगेट डिवाइस पर Play Services for AR का वर्शन 1.29.0 या इसके बाद का वर्शन इंस्टॉल हो.

2. ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में, मौजूदा <application> एलिमेंट के चाइल्ड के तौर पर नया <meta-data> टैग जोड़ें :

   <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 (ARCore SDK टूल का वर्शन 1.20.0)	जिन एपीआई पर असर पड़ा है उन्हें बंद कर दें और ड्रॉप-इन एपीआई के विकल्प उपलब्ध कराएं.
फ़रवरी 2021 (ARCore SDK टूल का वर्शन 1.23.0)	ARCore SDK से, पहले से बंद किए गए एपीआई के हस्ताक्षर हटाना.
नवंबर 2021	नवंबर 2022 में, Google Play Services for AR से उन एपीआई को हटाने की वजह से, आने वाले समय में होने वाले बड़े बदलाव का एलान करें जिन पर असर पड़ा है.
नवंबर 2022	Google Play Services for AR से, उन एपीआई को हटा दें जिन पर असर पड़ा है. 1.23.0 से पहले के ARCore वर्शन का इस्तेमाल करने वाले ऐप्लिकेशन के लिए, एक अहम बदलाव किया गया है.