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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

व्यवहार में हुए हर बदलाव के लिए, जब आपका ऐप्लिकेशन पहली बार प्रभावित एपीआई को कॉल करता है, तब सिस्टम इस तरह का 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 16 (एपीआई लेवल 36)
• Android 15 (एपीआई लेवल 35)
• Android 14 (एपीआई लेवल 34)
• Android 13 (एपीआई लेवल 33)
• Android 12 (एपीआई लेवल 31 और 32)
• Android 11 (एपीआई लेवल 30)

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

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

बदलावों को टॉगल करके बंद करने की सुविधा कब इस्तेमाल करें

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

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

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

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

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

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

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

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

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

बदलावों को टॉगल करके चालू करने का विकल्प कब दिखता है

किसी खास targetSDKVersion से जुड़ी सुविधाएं, डिफ़ॉल्ट रूप से बंद होती हैं. ऐसा तब होता है, जब कोई ऐप्लिकेशन, 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 के हिसाब से किए गए बदलाव	अन्य सभी बदलाव
डेवलपर के लिए झलक या बीटा वर्शन	टॉगल नहीं किया जा सकता	टॉगल कर सकता है	टॉगल कर सकता है
सार्वजनिक उपयोगकर्ता बिल्ड	टॉगल नहीं किया जा सकता	टॉगल कर सकता है	टॉगल नहीं किया जा सकता