नवंबर 2022 में, Android के लिए ARCore SDK टूल (Kotlin/Java) से कैमरा इस्तेमाल करने के तरीकों को हटाना

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

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

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

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

  1. आपके ऐप्लिकेशन को, समस्या वाले SDK टूल के साथ कंपाइल किया गया था
  2. आपका ऐप्लिकेशन, इनमें से किसी भी एपीआई का इस्तेमाल करता है:
अगर आपके ऐप्लिकेशन को
ARCore SDK टूल के वर्शन के साथ कंपाइल किया गया था… 		और जिन एपीआई पर असर पड़ा है उनका इस्तेमाल करता है… नवंबर 2022 से, ब्रेकिंग बिहेवियर की सुविधा बंद की जा रही है
1.19.0 या उससे पहले का वर्शन Frame.getImageMetadata() थ्रो IllegalArgumentException.
1.10.0 या उससे पहले का वर्शन Frame.acquireCameraImage() 0x0 साइज़ की इमेज दिखाता है.

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

जिन ऐप्लिकेशन पर असर पड़ा है उन्हें नवंबर 2022 में समस्याएं आ सकती हैं. इसे कम करने के लिए, ARCore SDK टूल के नए वर्शन का इस्तेमाल करके, अपने ऐप्लिकेशन को फिर से बनाएं. आपको कम से कम, ARCore SDK टूल के 1.20.0 या इसके बाद के वर्शन पर अपग्रेड करना होगा.

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

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