👨🏾‍🏭 👈🏼 🧡 Android एपीआई स्तर, पिछड़े और आगे संगतता 🧑🏿‍🤝‍🧑🏽 👨‍👧‍👧 🍀

शुभ संध्या दोस्तों। हमने एंड्रॉइड डेवलपर के भविष्य के छात्रों के लिए एक उपयोगी अनुवाद तैयार किया है । उन्नत पाठ्यक्रम । ” हम इस सामग्री को आपके साथ साझा करके खुश हैं।

यदि आप इस लेख को पढ़ रहे हैं, तो इसका मतलब है कि आप इस तरह की चीजों में दिलचस्पी ले सकते हैं:

एपीआई स्तर का क्या अर्थ है?
compileSdkVersion , minSdkVersion या targetSdkVersion का उपयोग कैसे करें?
मैं कैसे गारंटी दे सकता हूं कि एप्लिकेशन ओएस के विभिन्न संस्करणों के साथ उपकरणों पर सही ढंग से काम करेगा?

ये सभी अवधारणाएं एक-दूसरे से संबंधित हैं, और मैं आपको इस लेख में उन्हें एक सरल लेकिन प्रभावी तरीके से समझाने की कोशिश करूंगा।

ऐसा करने के लिए, आपको एसडीके और एपीआई के बीच अंतर को समझना होगा और यह जानना होगा कि एंड्रॉइड पारिस्थितिकी तंत्र में एपीआई स्तर क्या है ।

यह सच है कि एंड्रॉइड में एसडीके और एपीआई के बीच 1: 1 संबंध है, और अक्सर इन दो शब्दों को समान रूप से उपयोग किया जाता है, लेकिन यह समझना महत्वपूर्ण है कि यह एक ही बात नहीं है।

यह कहना अधिक सही है कि Android के प्रत्येक संस्करण के लिए SDK और समतुल्य API है, साथ ही इस API का स्तर भी है।

एसडीके

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

यदि आप एंड्रॉइड स्टूडियो में एसडीके प्रबंधक खोलते हैं, तो आप अधिक स्पष्ट रूप से देख सकते हैं कि एंड्रॉइड एसडीके में क्या है।

प्लेटफ़ॉर्म SDK का पहला टैब Android के प्रत्येक संस्करण के SDK को सूचीबद्ध करता है।

जैसा कि नीचे दी गई छवि में दिखाया गया है, एंड्रॉइड 9.0 एसडीके (पाई के रूप में भी जाना जाता है) में शामिल हैं:

एंड्रॉइड एसडीके प्लेटफॉर्म 28 (यह फ्रेमवर्क एपीआई है )।
एंड्रॉइड 28 के लिए स्रोत कोड (यह एपीआई का कार्यान्वयन है , जैसा कि आप देख सकते हैं, यह वैकल्पिक है ... इसे याद रखें)।
और अन्य चीजों का एक गुच्छा ... उदाहरण के लिए, एंड्रॉइड एमुलेटर के लिए विभिन्न सिस्टम छवियां।

एंड्रॉइड स्टूडियो एसडीके प्रबंधक में एसडीके का अवलोकन।

एसडीके टूल्स का दूसरा टैब अन्य उपकरण दिखाता है जो एसडीके का भी हिस्सा हैं लेकिन प्लेटफॉर्म संस्करण से स्वतंत्र हैं। इसका मतलब है कि उन्हें अलग से जारी या अद्यतन किया जा सकता है।

एपीआई

यह एप्लीकेशन प्रोग्रामिंग इंटरफेस के लिए है । यह सिर्फ एक इंटरफ़ेस है, एक अमूर्त परत जो सॉफ्टवेयर के दो अलग-अलग "भागों" के बीच एक लिंक प्रदान करता है। यह एक प्रदाता (उदाहरण के लिए, एक पुस्तकालय) और एक उपभोक्ता (उदाहरण के लिए, एक आवेदन) के बीच एक अनुबंध की तरह काम करता है।

यह औपचारिक परिभाषाओं का एक समूह है, जैसे कि कक्षाएं, विधियाँ, कार्य, मॉड्यूल, स्थिरांक, जो अन्य डेवलपर्स द्वारा अपना कोड लिखने के लिए उपयोग किया जा सकता है। हालांकि, एपीआई में कार्यान्वयन शामिल नहीं है।

एपीआई स्तर

एपीआई स्तर एक पूर्णांक मान है जो विशिष्ट रूप से एंड्रॉइड प्लेटफ़ॉर्म द्वारा प्रस्तावित फ्रेमवर्क के संस्करण की पहचान करता है।

आमतौर पर, प्लेटफ़ॉर्म फ्रेमवर्क एपीआई अपडेट को डिज़ाइन किया जाता है ताकि एपीआई का नया संस्करण पहले के संस्करणों के साथ संगत रहे, इसलिए नए एपीआई में अधिकांश परिवर्तन एडिटिव होते हैं, और एपीआई के पुराने हिस्से अप्रचलित हो जाते हैं लेकिन हटाए नहीं जाते हैं।

और अब किसी को आश्चर्य हो सकता है ...

यदि एंड्रॉइड एपीआई एक कार्यान्वयन प्रदान नहीं करता है, और एसडीके प्रबंधक एसडीके के हिस्से के रूप में एक वैकल्पिक डाउनलोड करने योग्य एपीआई स्रोत कोड प्रदान करता है, तो संबंधित कार्यान्वयन कहां है?

जवाब आसान है। डिवाइस पर।

चलिए इसका पता लगाते हैं ...

सोर्स कोड से एपीके फाइल तक

आमतौर पर, एक एंड्रॉइड प्रोजेक्ट में एंड्रॉइड एपीआई (एप्लिकेशन मॉड्यूल), साथ ही कुछ अन्य पुस्तकालयों (निर्भरता), (एएआर फाइलें, एएआर, मॉड्यूल, आदि) और संसाधनों का उपयोग करके डेवलपर्स द्वारा लिखित कोड होते हैं।

संकलन प्रक्रिया जावा या कोटलिन में लिखी गई कोड को धर्मान्तरित करती है, जिसमें निर्भरता (आपके कोड को कम करने के कारणों में से एक!), DEX बाइटकोड में, और फिर संसाधनों के साथ एपीके फ़ाइल में सब कुछ संपीड़ित करता है। इस स्तर पर, एपीके का कार्यान्वयन अंतिम एपीके में शामिल नहीं है!

बिल्ड प्रोसेस - एंड्रॉइड डेवलपर्स

DEX फ़ाइलें और Android रनटाइम

एंड्रॉइड आर्किटेक्चर - एंड्रॉइड डेवलपर्स

एंड्रॉइड रनटाइम वह जगह है जहां सभी गंदे काम किए जाते हैं और जहां DEX फ़ाइलों को निष्पादित किया जाता है। इसमें दो मुख्य घटक होते हैं:

कोड पोर्टेबिलिटी और प्लेटफॉर्म स्वतंत्रता का लाभ उठाने के लिए एक वर्चुअल मशीन । एंड्रॉइड 5.0 (लॉलीपॉप) के साथ शुरू हुआ, पुराने रनटाइम, Dalvik वर्चुअल मशीन को पूरी तरह से नए एंड्रॉइड रनटाइम (ART) द्वारा बदल दिया गया है। Dalvik ने JIT कंपाइलर का उपयोग किया, जबकि ART रन के समय कोड को प्रोफाइल करने के लिए AOT (समय से आगे) संकलन JIT का उपयोग करता है।
बेस लाइब्रेरी मानक जावा और एंड्रॉइड लाइब्रेरी हैं। सीधे शब्दों में कहें, तो यह वह जगह है जहां एपीआई कार्यान्वयन स्थित है।

इस स्तर पर उपलब्ध एपीआई का संस्करण एंड्रॉइड प्लेटफॉर्म के संस्करण से मेल खाता है, जिस पर एप्लिकेशन चल रहा है।

उदाहरण के लिए, यदि एंड्रॉइड 9 (पाई) वास्तविक डिवाइस पर स्थापित किया गया है, तो 28 स्तर तक के सभी एपीआई उपलब्ध हैं।

यदि आप एंड्रॉइड रनटाइम के मुख्य बिंदुओं को समझते हैं और एपीआई की भूमिका क्या है, तो पिछड़े और आगे की संगतता को समझने में आसान होना चाहिए, साथ ही साथ compileSdkVersion , compileSdkVersion और compileSdkVersion का उपयोग करना।

compileSdkVersion

इस मूल्य का उपयोग केवल ग्रेड को बताने के लिए किया जाता है कि आपके आवेदन को संकलित करने के लिए एसडीके का कौन सा संस्करण है। यह डेवलपर्स को compileSdkVersion लिए निर्धारित एपीआई स्तर तक उपलब्ध सभी एपीआई का उपयोग करने की अनुमति देता है।

नवीनतम एसडीके के साथ संकलित करने की अत्यधिक अनुशंसा की जाती है:

एपीआई का एक उच्च स्तर डेवलपर्स को नवीनतम एपीआई और नए प्लेटफार्मों द्वारा प्रदान किए गए अवसरों का लाभ उठाने की अनुमति देता है।
SupportLibrary के नवीनतम संस्करण का उपयोग करने के लिए, compileSdkVersion को compileSdkVersion के संस्करण से मेल compileSdkVersion चाहिए।

उदाहरण के लिए, SupportLibrary-28.xx का उपयोग करने के लिए, compileSdkVersion भी 28 होना चाहिए।

AndroidX पर जाने या इसका उपयोग करने के लिए, compileSdkVersion को कम से कम 28 पर सेट किया जाना चाहिए।
Google Play से लक्ष्य API स्तर की आवश्यकताओं को पूरा करने के लिए तैयार रहें। Google ने घोषणा की कि प्रत्येक वर्ष यह नए अनुप्रयोगों और अपडेट के लिए न्यूनतम एपीआई लक्ष्य स्तर निर्धारित करेगा ताकि नए एंड्रॉइड संस्करणों को Google बाजार में और अधिक तेज़ी से फैलाया जा सके। आप यहाँ और अधिक जानकारी पा सकते हैं।

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

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

उदाहरण के लिए:

एप्लिकेशन + compileSdkVersion = 26 और एपीआई xyz() विधि, एपीआई स्तर 26 में पेश किया गया, एंड्रॉइड 8 ओरेओ (एपीआई स्तर 26) के साथ एक डिवाइस पर काम कर सकता है।

एक ही एप्लिकेशन एंड्रॉइड 9 पाई (एपीआई स्तर 28) के साथ एक डिवाइस पर काम कर सकता है, चूंकि एपीआई xyz() विधि अभी भी एपीआई स्तर 28 पर उपलब्ध है।

minSdkVersion

यह मान न्यूनतम API स्तर इंगित करता है जिस पर अनुप्रयोग चल सकता है। यह एक न्यूनतम आवश्यकता है। यदि निर्दिष्ट नहीं है, तो डिफ़ॉल्ट मान 1 है ।

डेवलपर्स को सही मूल्य निर्धारित करने और इस एपीआई स्तर तक आवेदन के सही संचालन को सुनिश्चित करने की आवश्यकता होती है। इसे पिछड़ी अनुकूलता कहते हैं ।

विकास के दौरान, Lint डेवलपर्स Lint भी चेतावनी Lint जब वे minSdkVersion में निर्दिष्ट किसी भी एपीआई के नीचे का उपयोग करने का प्रयास करेंगे। यह बहुत महत्वपूर्ण है कि चेतावनियों को नजरअंदाज न करें और उन्हें सही करें!

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

यह उल्लेख करना भी महत्वपूर्ण है कि Google Play Store इस मान का उपयोग यह निर्धारित करने के लिए करता है कि क्या एप्लिकेशन को किसी विशिष्ट डिवाइस पर minSdkVersion अनुप्रयोग के साथ डिवाइस प्लेटफ़ॉर्म के संस्करण की तुलना करके स्थापित किया जा सकता है।

इस मूल्य को चुनते समय डेवलपर्स को बहुत सावधान रहना चाहिए, क्योंकि मंच द्वारा पिछड़े संगतता की गारंटी नहीं है।

किसी परियोजना के लिए "सही" मान चुनना भी एक व्यावसायिक निर्णय है, क्योंकि यह प्रभावित करता है कि आवेदन के दर्शक कितने बड़े होंगे। प्लेटफार्मों के वितरण को देखें ।

उदाहरण के लिए:

एप्लिकेशन + compileSdkVersion = 26 + minSdkVersion = 22 और एपीआई स्तर 26 में शुरू की गई एपीआई xyz() विधि एंड्रॉइड 8 ओरेओ (एपीआई स्तर 26) के साथ एक डिवाइस पर काम कर सकती है।

एक ही एप्लिकेशन को एंड्रॉइड 5.1 लॉलीपॉप (एपीआई स्तर 22) के साथ एक पुराने डिवाइस पर स्थापित और चलाया जा सकता है, जहां एपीआई विधि xyz() मौजूद नहीं है। यदि डेवलपर्स ने रनटाइम चेक के माध्यम से या किसी लाइब्रेरी के माध्यम से पिछड़े संगतता प्रदान नहीं किया है, तो जैसे ही यह xyz() एपीआई विधि का उपयोग करने का प्रयास करता है, तो एप्लिकेशन क्रैश हो जाएगा।

targetSdkVersion

यह मान API के उस स्तर को इंगित करता है जिस पर एप्लिकेशन विकसित किया गया था।

इसे compileSdkVersion भ्रमित न करें। उत्तरार्द्ध केवल संकलन समय पर उपयोग किया जाता है और डेवलपर्स के लिए नए एपीआई उपलब्ध कराता है। इसके विपरीत, पहला, एपीके का हिस्सा है (साथ ही minSdkVersion ) और रनटाइम के व्यवहार को बदलता है। यह वह तरीका है जिससे डेवलपर्स प्रत्यक्ष संगतता को नियंत्रित कर सकते हैं।

कभी-कभी आधार प्रणाली में कुछ एपीआई परिवर्तन हो सकते हैं जो नए रनटाइम वातावरण में काम करते समय एप्लिकेशन के व्यवहार को प्रभावित कर सकते हैं।

लक्ष्य एप्लिकेशन स्तर में रनटाइम व्यवहार शामिल है जो प्लेटफ़ॉर्म संस्करण के लिए विशिष्ट है। यदि अनुप्रयोग रनटाइम व्यवहार के लिए इन परिवर्तनों का समर्थन करने के लिए तैयार नहीं है, तो यह विफल होने की संभावना है।

एक सरल उदाहरण रनटाइम परमिशन है , जिसे एंड्रॉइड 6 मार्शमैलो (एपीआई स्तर 23) में पेश किया गया था।

एक स्तर 23 एपीआई का उपयोग करके एक आवेदन संकलित किया जा सकता है, लेकिन एक लक्ष्य स्तर 22 एपीआई है अगर यह अभी तक नए रनवे अनुमति मॉडल का समर्थन करने के लिए तैयार नहीं है।

इस प्रकार, कोई एप्लिकेशन नए रनटाइम व्यवहार को शामिल किए बिना अभी भी संगत हो सकता है।

किसी भी मामले में, जैसा कि पहले ही उल्लेख किया गया है, Google को लक्ष्य एपीआई स्तर की नई आवश्यकताओं को पूरा करने के लिए अनुप्रयोगों की आवश्यकता होती है, इसलिए आपको इस मूल्य को अपडेट करने के लिए हमेशा उच्च प्राथमिकता होनी चाहिए।

अब यह सब एक साथ रखकर, हम एक स्पष्ट संबंध देखते हैं

minSdkVersion ≤ targetSdkVersion ≤ compileSdkVersion

ध्यान रखें कि यह अत्यधिक अनुशंसित है कि आप नवीनतम एपीआई स्तर के साथ संकलित करें और targetSdkVersion == compileSdkVersion का उपयोग करने का प्रयास करें।

Android एपीआई स्तर, पिछड़े और आगे संगतता