कंपैटिबिलिटी फ़्रेमवर्क टूल

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

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

यह कैसे पता लगाएं कि कौनसे बदलाव चालू हैं

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

'डेवलपर के लिए सेटिंग और टूल' का इस्तेमाल करके, चालू किए गए बदलावों की पहचान करना

पहली इमेज. 'ऐप्लिकेशन के साथ काम करने के लिए बदलाव' स्क्रीन पर जाएं.

आपके पास यह देखने का विकल्प होता है कि कौनसे बदलाव चालू हैं. साथ ही, डिवाइस के डेवलपर के विकल्पों में जाकर, उन बदलावों को चालू या बंद किया जा सकता है. इन विकल्पों को ऐक्सेस करने के लिए, यह तरीका अपनाएं:

1. अगर डेवलपर के लिए सेटिंग और टूल पहले से चालू नहीं हैं, तो उन्हें चालू करें.
2. अपने डिवाइस का सेटिंग ऐप्लिकेशन खोलें और सिस्टम > बेहतर > डेवलपर के लिए सेटिंग और टूल > ऐप्लिकेशन के साथ काम करने की सुविधा में हुए बदलाव पर जाएं.

3. सूची में से अपना ऐप्लिकेशन चुनें.

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

आम तौर पर, उपयोगकर्ता के व्यवहार में होने वाला हर बदलाव, इनमें से किसी एक कैटगरी में आता है:

• ऐसे बदलाव जिनका असर Android के उस वर्शन पर चलने वाले सभी ऐप्लिकेशन पर पड़ता है. भले ही, ऐप्लिकेशन का targetSdkVersion कुछ भी हो.

  ये बदलाव, कम्पैटिबिलिटी फ़्रेमवर्क में डिफ़ॉल्ट रूप से चालू होते हैं. साथ ही, ये यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट रूप से चालू बदलाव सेक्शन में दिखते हैं.

• ऐसे बदलाव जिनका असर सिर्फ़ उन ऐप्लिकेशन पर पड़ता है जो Android के कुछ वर्शन को टारगेट करते हैं. इन बदलावों का असर सिर्फ़ उन ऐप्लिकेशन पर पड़ेगा जो Android के किसी खास वर्शन को टारगेट करते हैं. इसलिए, इन्हें targetSDKVersion के गेट वाले बदलावों के तौर पर भी जाना जाता है.

  अगर आपका ऐप्लिकेशन, सूची में दिए गए एपीआई वर्शन के बजाय किसी नए वर्शन को टारगेट कर रहा है, तो ये बदलाव कंपैटिबिलिटी फ़्रेमवर्क में डिफ़ॉल्ट रूप से चालू होते हैं. उदाहरण के लिए, Android 13 (एपीआई लेवल 33) में targetSDKVersion के व्यवहार में होने वाला बदलाव, यूज़र इंटरफ़ेस (यूआई) में targetSdkVersion >=33 के लिए चालू किया गया सेक्शन दिखेगा. Android के कुछ पुराने वर्शन में, इस सेक्शन का शीर्षक "SDK API_LEVEL के बाद चालू किया गया" होता है.

  ध्यान दें: Android 15 के रिलीज़ होने से पहले, एपीआई लेवल तय होने तक, कुछ बदलाव सिर्फ़ तब चालू होते हैं, जब Android 15 को टारगेट किया जाता है. ये बदलाव, एपीआई लेवल के लिए 35 की जगह 10000 की वैल्यू का इस्तेमाल करते हैं. हालांकि, यह वैल्यू एपीआई लेवल के लिए तय की गई वैल्यू नहीं होती.

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

logcat का इस्तेमाल करके, चालू किए गए बदलावों की पहचान करना

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

D CompatibilityChangeReporter: Compat change id reported: 194833441; UID 10265; state: ENABLED

ध्यान दें: हर प्रोसेस में, हर बदलाव को ज़्यादा से ज़्यादा एक बार ही लॉग किया जाता है. अपने ऐप्लिकेशन की प्रोसेस को ज़बरदस्ती बंद करें और फिर से शुरू करें. इससे, आपको सभी ज़रूरी Logcat मैसेज दिखेंगे.

हर logcat मैसेज में यह जानकारी शामिल होती है:

आईडी बदलना

इससे पता चलता है कि ऐप्लिकेशन पर किस बदलाव का असर पड़ रहा है. यह वैल्यू, ऐप्लिकेशन के साथ काम करने के तरीके में हुए बदलाव स्क्रीन पर बताए गए व्यवहार में हुए किसी एक बदलाव से मैप होती है (पहला चित्र देखें). इस उदाहरण में, 194833441, NOTIFICATION_PERM_CHANGE_ID पर मैप होता है.

यूआईडी

इससे पता चलता है कि बदलाव का असर किस ऐप्लिकेशन पर पड़ा है.

राज्य

यह बताता है कि इस बदलाव का असर ऐप्लिकेशन पर पड़ रहा है या नहीं.

स्थिति इनमें से कोई एक हो सकती है:

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

ADB का इस्तेमाल करके चालू किए गए बदलावों की पहचान करना

पूरे डिवाइस पर किए गए बदलावों (चालू और बंद, दोनों) का पूरा सेट देखने के लिए, यह ADB कमांड चलाएं:

adb shell dumpsys platform_compat

आउटपुट में, हर बदलाव के लिए यह जानकारी दिखती है:

आईडी बदलें

इस व्यवहार में हुए बदलाव के लिए यूनीक आइडेंटिफ़ायर. उदाहरण के लिए, 194833441.

नाम

इस बदलाव का नाम. उदाहरण के लिए, NOTIFICATION_PERM_CHANGE_ID.

targetSDKVersion के लिए ज़रूरी शर्तें

बदलाव किस targetSDKVersion से लागू होता है (अगर कोई हो).

उदाहरण के लिए, अगर यह बदलाव सिर्फ़ SDK टूल के वर्शन 33 या उसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन के लिए चालू है, तो enableAfterTargetSdk=32 आउटपुट होता है. अगर बदलाव को targetSDKVersion से कंट्रोल नहीं किया जाता है, तो enableAfterTargetSdk=0 आउटपुट होता है.

पैकेज में बदलाव

हर उस पैकेज का नाम जहां बदलाव की डिफ़ॉल्ट स्थिति (चालू या बंद) को बदल दिया गया है.

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

packageOverrides={com.my.package=false}

targetSDKVersion के हिसाब से बदलावों को डिफ़ॉल्ट रूप से चालू या बंद किया जा सकता है. इसलिए, पैकेज की सूची में true या false, दोनों के इंस्टेंस शामिल हो सकते हैं. यह इस बात पर निर्भर करता है कि उन ऐप्लिकेशन के targetSDKVersion क्या हैं. जैसे:

packageOverrides={com.my.package=true, com.another.package=false}

खास बदलावों के बारे में ज़्यादा जानें

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

• Android 15 (एपीआई लेवल 35)
• Android 14 (एपीआई लेवल 34)
• Android 13 (एपीआई लेवल 33)
• Android 12 (एपीआई लेवल 31 और 32)
• Android 11 (एपीआई लेवल 30)

बदलावों को कब टॉगल करें

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

बदलावों को कब टॉगल करके बंद करना है

आम तौर पर, बदलावों को टॉगल कब बंद करना है, यह इस बात पर निर्भर करता है कि बदलाव targetSDKVersion से लागू है या नहीं.

सभी ऐप्लिकेशन के लिए चालू किए गए बदलाव

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

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

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

आपको इन बदलावों की जांच को भी प्राथमिकता देनी चाहिए, क्योंकि Android के सार्वजनिक रिलीज़ बिल्ड का इस्तेमाल करते समय, इन बदलावों को टॉगल करके बंद नहीं किया जा सकता. आम तौर पर, आपको Android के हर वर्शन के लिए, जब वह वर्शन झलक के तौर पर उपलब्ध हो, तब इन बदलावों की जांच करनी चाहिए.

targetSDKVersion के हिसाब से किए गए बदलाव

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

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

बदलावों को कब टॉगल करना है

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

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

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

बदलावों को टॉगल करके चालू या बंद करना

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

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

डेवलपर के लिए सेटिंग और टूल का इस्तेमाल करके, बदलावों को टॉगल करें

बदलावों को चालू या बंद करने के लिए, डेवलपर के विकल्पों का इस्तेमाल करें. डेवलपर के विकल्पों को ढूंढने के लिए, यह तरीका अपनाएं:

1. अगर डेवलपर के लिए सेटिंग और टूल पहले से चालू नहीं हैं, तो उन्हें चालू करें.
2. अपने डिवाइस का सेटिंग ऐप्लिकेशन खोलें और सिस्टम > बेहतर > डेवलपर के लिए सेटिंग और टूल > ऐप्लिकेशन के साथ काम करने की सुविधा में हुए बदलाव पर जाएं.
3. सूची में से अपना ऐप्लिकेशन चुनें.

4. बदलावों की सूची में, वह बदलाव ढूंढें जिसे आपको चालू या बंद करना है और स्विच पर टैप करें.

   

ADB का इस्तेमाल करके बदलावों को टॉगल करना

ADB का इस्तेमाल करके, किसी बदलाव को चालू या बंद करने के लिए, इनमें से कोई एक कमांड चलाएं:

adb shell am compat enable (CHANGE_ID|CHANGE_NAME) PACKAGE_NAME
adb shell am compat disable (CHANGE_ID|CHANGE_NAME) PACKAGE_NAME

CHANGE_ID (उदाहरण के लिए, 194833441) या CHANGE_NAME (उदाहरण के लिए, NOTIFICATION_PERM_CHANGE_ID) और अपने ऐप्लिकेशन का PACKAGE_NAME पास करें.

ADB या डेवलपर विकल्पों का इस्तेमाल करके सेट किए गए किसी बदलाव को हटाते हुए, किसी बदलाव को उसकी डिफ़ॉल्ट स्थिति पर रीसेट करने के लिए, नीचे दिए गए निर्देश का भी इस्तेमाल किया जा सकता है:

adb shell am compat reset (CHANGE_ID|CHANGE_NAME) PACKAGE_NAME

बदलावों को टॉगल करने पर पाबंदियां

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

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

बिल्ड किस तरह का है	डीबग नहीं किया जा सकने वाला ऐप्लिकेशन	डीबग किया जा सकने वाला ऐप्लिकेशन
	सभी बदलाव	targetSDKVersion से सुरक्षित किए गए बदलाव	अन्य सभी बदलाव
डेवलपर प्रीव्यू या बीटा बिल्ड	टॉगल नहीं किया जा सकता	टॉगल किया जा सकता है	टॉगल किया जा सकता है
सार्वजनिक उपयोगकर्ता बिल्ड	टॉगल नहीं किया जा सकता	टॉगल किया जा सकता है	टॉगल नहीं किया जा सकता