ऐप्लिकेशन को Android 13 पर माइग्रेट करना

इस दस्तावेज़ में, डेवलपमेंट और टेस्टिंग के सामान्य चरणों के बारे में खास जानकारी दी गई है. इससे आपको ऐप्लिकेशन को Android 13 के लिए तैयार करने का प्लान बनाने में मदद मिल सकती है. यह प्लान, प्लैटफ़ॉर्म की रिलीज़ की टाइमलाइन के हिसाब से बनाया जा सकता है. इससे Android 13 पर आपके उपयोगकर्ताओं को बेहतर अनुभव मिलेगा.

Android के हर नए वर्शन के साथ, हम नई सुविधाएं और व्यवहार में बदलाव लाते हैं. इनका मकसद, Android को ज़्यादा मददगार, सुरक्षित, और बेहतर बनाना है. ज़्यादातर मामलों में, आपका ऐप्लिकेशन उम्मीद के मुताबिक काम करेगा. हालांकि, कुछ मामलों में आपको अपने ऐप्लिकेशन को अपडेट करना पड़ सकता है, ताकि वह प्लैटफ़ॉर्म में हुए बदलावों के हिसाब से काम कर सके.

एओएसपी (Android ओपन सोर्स प्रोजेक्ट) में सोर्स कोड रिलीज़ होते ही, उपयोगकर्ताओं को नया प्लैटफ़ॉर्म मिलना शुरू हो सकता है. इसलिए, यह ज़रूरी है कि आपके ऐप्लिकेशन तैयार हों और उपयोगकर्ताओं के लिए उम्मीद के मुताबिक काम करें. साथ ही, नए प्लैटफ़ॉर्म का ज़्यादा से ज़्यादा फ़ायदा पाने के लिए, नई सुविधाओं और एपीआई का इस्तेमाल करें.

आम तौर पर, माइग्रेशन के दो चरण होते हैं. ये दोनों चरण एक साथ भी हो सकते हैं:

  • ऐप्लिकेशन के साथ काम करने की सुविधा को पक्का करना (Android 13 की फ़ाइनल रिलीज़ तक)
  • प्लैटफ़ॉर्म की नई सुविधाओं और एपीआई को टारगेट करना (फ़ाइनल रिलीज़ के बाद, जल्द से जल्द)

यह पक्का करना कि ऐप्लिकेशन, Android 13 के साथ काम करता हो

यह ज़रूरी है कि आप Android 13 पर अपने मौजूदा ऐप्लिकेशन की सुविधाओं की जांच करें. इससे, Android के नए वर्शन पर अपडेट करने वाले उपयोगकर्ताओं को बेहतर अनुभव मिलेगा. प्लैटफ़ॉर्म में किए गए कुछ बदलावों का असर, आपके ऐप्लिकेशन के काम करने के तरीके पर पड़ सकता है. इसलिए, यह ज़रूरी है कि आप अपने ऐप्लिकेशन की जांच जल्द से जल्द और अच्छी तरह से करें. साथ ही, ज़रूरत के हिसाब से उसमें बदलाव करें.

आम तौर पर, ऐप्लिकेशन के targetSdkVersion में बदलाव किए बिना, ऐप्लिकेशन में बदलाव किया जा सकता है और अपडेट पब्लिश किया जा सकता है. इसी तरह, आपको नए एपीआई इस्तेमाल करने या ऐप्लिकेशन के compileSdkVersion में बदलाव करने की ज़रूरत नहीं है. हालांकि, यह इस बात पर निर्भर करता है कि आपका ऐप्लिकेशन किस तरह बनाया गया है और वह किस प्लैटफ़ॉर्म की सुविधाओं का इस्तेमाल कर रहा है.

टेस्टिंग शुरू करने से पहले, सभी ऐप्लिकेशन के लिए व्यवहार में होने वाले बदलावों के बारे में ज़रूर जान लें. इन बदलावों का असर आपके ऐप्लिकेशन पर पड़ सकता है. भले ही, आपने इसके targetSdkVersion में बदलाव न किया हो.

Android 13 डाउनलोड करना

अपने डिवाइस पर Android 13 की सिस्टम इमेज फ़्लैश करें या Android Emulator के लिए सिस्टम इमेज डाउनलोड करें.

बदलावों की समीक्षा करना

सिस्टम के काम करने के तरीके में हुए बदलावों की समीक्षा करें, ताकि उन जगहों की पहचान की जा सके जहां आपके ऐप्लिकेशन पर असर पड़ सकता है.

टेस्ट

अपने डिवाइस या एम्युलेटर पर ऐप्लिकेशन इंस्टॉल करें और टेस्ट चलाएं. सिस्टम के काम करने के तरीके में हुए बदलावों पर ध्यान दें और ऐप्लिकेशन के सभी फ़्लो पर काम करें.

अपडेट

कोड में सिर्फ़ वे बदलाव करें जो व्यवहार में होने वाले बदलावों के हिसाब से ज़रूरी हों या समस्याओं को हल करने के लिए ज़रूरी हों. उसी एपीआई लेवल के साथ फिर से कंपाइल करें जिसे आपके ऐप्लिकेशन ने मूल रूप से टारगेट किया था. Android 13 को टारगेट करने की ज़रूरत नहीं है.

पब्लिश करना

अपडेट किए गए Android ऐप्लिकेशन बंडल या APK पर साइन करें, उसे अपलोड करें, और पब्लिश करें.

कंपैटिबिलिटी टेस्टिंग करना

Android 13 के साथ काम करने की क्षमता की जांच करना, ज़्यादातर मामलों में सामान्य ऐप्लिकेशन की जांच करने जैसा ही है. यह ऐप्लिकेशन की क्वालिटी से जुड़े मुख्य दिशा-निर्देशों और टेस्टिंग के सबसे सही तरीकों को देखने का सही समय है.

टेस्ट करने के लिए, Android 13 वाले डिवाइस पर, पब्लिश किया गया अपना मौजूदा ऐप्लिकेशन इंस्टॉल करें. इसके बाद, ऐप्लिकेशन के सभी फ़्लो और सुविधाओं को इस्तेमाल करके देखें कि उनमें कोई समस्या तो नहीं है. टेस्टिंग पर फ़ोकस करने के लिए, सभी ऐप्लिकेशन के लिए, व्यवहार में होने वाले बदलावों की समीक्षा करें. ये बदलाव, Android 13 में पेश किए गए हैं. इनसे आपके ऐप्लिकेशन के काम करने के तरीके पर असर पड़ सकता है या आपका ऐप्लिकेशन क्रैश हो सकता है.

साथ ही, पाबंदी वाले गैर-एसडीके इंटरफ़ेस के इस्तेमाल की समीक्षा और जांच ज़रूर करें. आपको अपने ऐप्लिकेशन में इस्तेमाल किए गए किसी भी प्रतिबंधित इंटरफ़ेस को, सार्वजनिक एसडीके या एनडीके के बराबर वाले इंटरफ़ेस से बदलना चाहिए. Logcat से मिलने वाली उन चेतावनियों पर नज़र रखें जो इस तरह के ऐक्सेस को हाइलाइट करती हैं. साथ ही, प्रोग्राम के हिसाब से उन्हें पकड़ने के लिए, StrictMode तरीके detectNonSdkApiUsage() का इस्तेमाल करें.

आखिर में, अपने ऐप्लिकेशन में मौजूद लाइब्रेरी और एसडीके टूल की पूरी तरह से जांच करें, ताकि यह पक्का किया जा सके कि वे Android 13 पर उम्मीद के मुताबिक काम करें. साथ ही, निजता, परफ़ॉर्मेंस, उपयोगकर्ता अनुभव, डेटा मैनेज करने, और अनुमतियों के लिए सबसे सही तरीके अपनाएं. अगर आपको कोई समस्या मिलती है, तो एसडीके को नए वर्शन पर अपडेट करें या मदद के लिए एसडीके डेवलपर से संपर्क करें.

जांच पूरी करने और ज़रूरी अपडेट करने के बाद, हमारा सुझाव है कि आप Android Auto के साथ काम करने वाले अपने ऐप्लिकेशन को तुरंत पब्लिश करें. इससे आपके उपयोगकर्ता, ऐप्लिकेशन को पहले ही टेस्ट कर सकते हैं. साथ ही, Android 13 पर अपडेट करने के बाद, उन्हें ऐप्लिकेशन इस्तेमाल करने में कोई परेशानी नहीं होती.

ऐप्लिकेशन के टारगेट एपीआई लेवल को अपडेट करना और नए एपीआई के साथ बिल्ड करना

अपने ऐप्लिकेशन का ऐसा वर्शन पब्लिश करने के बाद जो Android 13 के साथ काम करता हो, अगला कदम है कि ऐप्लिकेशन में Android 13 के लिए पूरी तरह से सहायता जोड़ी जाए. इसके लिए, ऐप्लिकेशन के targetSdkVersion को अपडेट करें. साथ ही, Android 13 में मौजूद नए एपीआई और सुविधाओं का फ़ायदा लें. नए प्लैटफ़ॉर्म को टारगेट करने के लिए, Google Play की ज़रूरी शर्तों को ध्यान में रखते हुए, जब चाहें तब ये अपडेट किए जा सकते हैं.

Android 13 के साथ काम करने वाले ऐप्लिकेशन बनाने के लिए, Android 13 को टारगेट करने वाले ऐप्लिकेशन पर असर डालने वाले बदलावों को देखें. काम करने के तरीके में किए गए इन बदलावों की वजह से, ऐप्लिकेशन के काम करने के तरीके में समस्याएं आ सकती हैं. आपको इन समस्याओं को ठीक करना होगा. कुछ मामलों में, इन बदलावों को लागू करने के लिए काफ़ी डेवलपमेंट की ज़रूरत होती है. इसलिए, हमारा सुझाव है कि आप इनके बारे में जल्द से जल्द जानें और इन्हें लागू करें. आपके ऐप्लिकेशन पर असर डालने वाले व्यवहार से जुड़े खास बदलावों की पहचान करने के लिए, साथ काम करने वाले टॉगल का इस्तेमाल करें. इससे, चुने गए बदलावों को चालू करके अपने ऐप्लिकेशन की जांच की जा सकती है.

यहां दिए गए तरीके से, Android 13 के साथ पूरी तरह से काम करने वाले ऐप्लिकेशन बनाए जा सकते हैं.

Android 13 SDK टूल डाउनलोड करना

Android 13 के साथ ऐप्लिकेशन बनाने के लिए, Android Studio की झलक का नया वर्शन इंस्टॉल करें. पक्का करें कि आपके पास Android 13 डिवाइस या एम्युलेटर हो.
अपना targetSdkVersion और अन्य बिल्ड कॉन्फ़िगरेशन अपडेट करें.

ऐप्लिकेशन के व्यवहार में हुए बदलावों की समीक्षा करना

Android 13 को टारगेट करने वाले ऐप्लिकेशन के लिए, काम करने के तरीके में हुए बदलावों की समीक्षा करें. उन क्षेत्रों की पहचान करें जहां आपके ऐप्लिकेशन पर असर पड़ सकता है. साथ ही, उन क्षेत्रों में ऐप्लिकेशन को बेहतर बनाने का प्लान बनाएं.

निजता से जुड़े नए बदलावों के बारे में जानना

Android 13 में उपयोगकर्ता की निजता से जुड़े बदलावों के हिसाब से, कोड और आर्किटेक्चर में ज़रूरी बदलाव करें.

Android 13 की सुविधाएं अपनाएं

Android 13 के एपीआई का फ़ायदा लें, ताकि आपके ऐप्लिकेशन में नई सुविधाएं और क्षमताएं जोड़ी जा सकें. Android 13 के लिए फिर से कंपाइल करें.

टेस्ट

Android 13 डिवाइस या एम्युलेटर पर टेस्ट करें. उन जगहों पर फ़ोकस करें जहां व्यवहार में बदलाव होने से आपके ऐप्लिकेशन पर असर पड़ सकता है. नए एपीआई का इस्तेमाल करने वाली सुविधाओं को आज़माएं. प्लैटफ़ॉर्म और एपीआई के बारे में सुझाव/राय देना या शिकायत करना. प्लैटफ़ॉर्म, एपीआई या तीसरे पक्ष के SDK टूल से जुड़ी किसी भी समस्या की शिकायत करें.

आखिरी अपडेट

Android 13 के एपीआई फ़ाइनल होने के बाद, अपने targetSdkVersion और अन्य बिल्ड कॉन्फ़िगरेशन को फिर से अपडेट करें. साथ ही, कोई अन्य अपडेट करें और अपने ऐप्लिकेशन की जांच करें.

पब्लिश करना

अपडेट किए गए Android ऐप्लिकेशन बंडल या APK पर साइन करें, उसे अपलोड करें, और पब्लिश करें.

SDK टूल डाउनलोड करना, टारगेटिंग में बदलाव करना, और नए एपीआई की मदद से ऐप्लिकेशन बनाना

Android 13 के साथ पूरी तरह से काम करने वाले ऐप्लिकेशन की जांच शुरू करने के लिए, Android Studio के सबसे नए वर्शन की झलक का इस्तेमाल करें. इससे, Android 13 SDK टूल और अपनी ज़रूरत के अन्य टूल डाउनलोड किए जा सकते हैं. इसके बाद, अपने ऐप्लिकेशन के targetSdkVersion और compileSdkVersion को अपडेट करें. साथ ही, ऐप्लिकेशन को फिर से कंपाइल करें. ज़्यादा जानकारी के लिए, एसडीके सेटअप करने की गाइड देखें.

Android 13 पर काम करने वाले अपने ऐप्लिकेशन की जांच करना

ऐप्लिकेशन को कंपाइल करने और उसे Android 13 पर चलने वाले डिवाइस पर इंस्टॉल करने के बाद, यह पक्का करने के लिए जांच शुरू करें कि Android 13 को टारगेट करते समय ऐप्लिकेशन ठीक से काम कर रहा है या नहीं. सिस्टम के काम करने के तरीके में होने वाले कुछ बदलाव सिर्फ़ तब लागू होते हैं, जब आपका ऐप्लिकेशन नए प्लैटफ़ॉर्म को टारगेट कर रहा हो. इसलिए, शुरू करने से पहले आपको उन बदलावों की समीक्षा करनी होगी.

बेसिक कंपैटबिलिटी टेस्टिंग की तरह ही, सभी फ़्लो और फ़ंक्शन की जांच करके समस्याओं का पता लगाएं. Android 13 को टारगेट करने वाले ऐप्लिकेशन के लिए, काम करने के तरीके में हुए बदलावों की टेस्टिंग पर फ़ोकस करें. यह ऐप्लिकेशन की क्वालिटी के लिए बने दिशा-निर्देशों और जांच करने के सबसे सही तरीकों के हिसाब से, अपने ऐप्लिकेशन की जांच करने का भी सही समय है.

पाबंदी वाले गैर-एसडीके इंटरफ़ेस के इस्तेमाल की समीक्षा करें और उनकी जांच करें. ऐसा हो सकता है कि ये इंटरफ़ेस आपके ऐप्लिकेशन पर लागू हों. Logcat से मिलने वाली उन चेतावनियों पर नज़र रखें जो इस तरह के ऐक्सेस को हाइलाइट करती हैं. साथ ही, प्रोग्राम के हिसाब से उन्हें पकड़ने के लिए, StrictMode तरीके detectNonSdkApiUsage() का इस्तेमाल करें.

आखिर में, अपने ऐप्लिकेशन में मौजूद लाइब्रेरी और एसडीके टूल की पूरी तरह से जांच करें, ताकि यह पक्का किया जा सके कि वे Android 13 पर उम्मीद के मुताबिक काम करें. साथ ही, निजता, परफ़ॉर्मेंस, उपयोगकर्ता अनुभव, डेटा मैनेज करने, और अनुमतियों के लिए सबसे सही तरीके अपनाएं. अगर आपको कोई समस्या मिलती है, तो एसडीके को नए वर्शन पर अपडेट करें या मदद के लिए एसडीके डेवलपर से संपर्क करें.

ऐप्लिकेशन के साथ काम करने की सुविधा के टॉगल इस्तेमाल करके जांच करना

Android 13 में, साथ काम करने वाले टॉगल शामिल हैं. इनकी मदद से, टारगेट किए गए व्यवहार में बदलावों के साथ अपने ऐप्लिकेशन को आसानी से टेस्ट किया जा सकता है. डीबग करने लायक ऐप्लिकेशन के लिए, टॉगल की मदद से ये काम किए जा सकते हैं:

  • ऐप्लिकेशन के targetSdkVersion में बदलाव किए बिना, सिस्टम में किए गए खास बदलावों की जांच करें. टॉगल का इस्तेमाल करके, खास तरह के व्यवहार से जुड़े कुछ बदलावों को हमेशा चालू रखा जा सकता है. इससे, अपने मौजूदा ऐप्लिकेशन पर पड़ने वाले असर का आकलन किया जा सकता है.
  • सिर्फ़ खास बदलावों पर टेस्टिंग करें. टारगेट किए गए सभी बदलावों की एक साथ जांच करने के बजाय, टॉगल की मदद से चुनिंदा बदलावों की जांच की जा सकती है. आपको जिन बदलावों की जांच नहीं करनी है उन सभी को टॉगल करके बंद किया जा सकता है.
  • एडीबी की मदद से टॉगल मैनेज करना. एडीबी कमांड का इस्तेमाल करके, ऑटोमेटेड टेस्ट एनवायरमेंट में इन खास बदलावों को चालू और बंद किया जा सकता है.
  • स्टैंडर्ड चेंज आईडी का इस्तेमाल करके, तेज़ी से डीबग करें. टॉगल किए जा सकने वाले हर बदलाव का एक यूनीक आईडी और नाम होता है. इनका इस्तेमाल करके, लॉग आउटपुट में समस्या की असल वजह का तुरंत पता लगाया जा सकता है.

अपने ऐप्लिकेशन की टारगेटिंग में बदलाव करने की तैयारी करते समय या Android 13 के साथ काम करने वाले ऐप्लिकेशन को डेवलप करते समय, टॉगल आपकी मदद कर सकते हैं. ज़्यादा जानकारी के लिए, कंपैटबिलिटी फ़्रेमवर्क में हुए बदलाव (Android 13) देखें.