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

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

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

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

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

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

पक्का करना कि सिस्टम, Android 13 के साथ काम करता हो

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

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

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

डिवाइस के साथ काम करने की जांच करना

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

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

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

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

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

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

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

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

यहां Android 13 के साथ पूरी तरह से काम करने का तरीका बताया गया है.

SDK टूल पाना, टारगेटिंग में बदलाव करना, नए एपीआई के साथ बनाना

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

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

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

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

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

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

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

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

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

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