Google Maps Platform की टीम, एसडीके को नई सुविधाओं, गड़बड़ियों को ठीक करने वाले अपडेट, और परफ़ॉर्मेंस में सुधार करने वाले अपडेट के साथ नियमित तौर पर अपडेट करती है. इस पेज पर, मोबाइल एसडीके पर अपनी डिपेंडेंसी मैनेज करने का तरीका बताया गया है.
किस वर्शन को लिंक करें?
-
मिशन-क्रिटिकल ऐप्लिकेशन के लिए, उस मुख्य वर्शन के सबसे नए डॉट रिलीज़ से लिंक करें जिसका इस्तेमाल किया जा रहा है (X.*). साथ ही, हर साल नए मुख्य वर्शन पर अपग्रेड करें.
साल भर में अपने ऐप्लिकेशन के नए वर्शन रिलीज़ करते समय, हो सकता है कि Places SDK for Android के नए डॉट वर्शन का इस्तेमाल किया जाए. इसके लिए, आपको अपने ऐप्लिकेशन में अपडेट करने की ज़रूरत नहीं होगी, क्योंकि नए डॉट वर्शन, पुराने वर्शन के साथ काम करते हैं.
फ़ायदे:
- अगर आपको Places SDK for Android में समस्याएं मिलती हैं, तो मोबाइल सहायता नीति के मुताबिक, मुख्य वर्शन की शुरुआती रिलीज़ के 12 महीने बाद तक, पुराने वर्शन के साथ काम करने वाले फ़िक्स उपलब्ध कराए जाएंगे. फ़िक्स का फ़ायदा पाने के लिए, आपको पुराने वर्शन के साथ काम न करने वाले एसडीके वर्शन पर तुरंत अपग्रेड करने की ज़रूरत नहीं होगी.
- अगर आपका ऐप्लिकेशन पहले से ही नए वर्शन पर बना है, तो उसमें नए सुधार और सुविधाएं आसानी से जोड़ी जा सकती हैं.
- एसडीके के नए मुख्य वर्शन के लिए, हर साल होने वाले इंक्रीमेंटल अपडेट को लागू करने, कोड को फिर से लिखने, और अपने ऐप्लिकेशन की टेस्टिंग करने में कम काम करना पड़ सकता है. ऐसा इसलिए, क्योंकि कई मुख्य वर्शन की रिलीज़ में, पुराने वर्शन के साथ काम न करने वाले बदलावों को मैनेज करने की ज़रूरत नहीं होती.
नॉन-क्रिटिकल ऐप्लिकेशन के लिए, किसी भी फ़िक्स किए गए वर्शन से लिंक करें. जब आपको उस फ़िक्स किए गए वर्शन के लिए, बंद होने की सूचना मिलती है, तो आपके पास अपडेट किए गए ऐप्लिकेशन के कोड को अपने उपयोगकर्ताओं के लिए उपलब्ध कराने के लिए 12 महीने होंगे.
फ़ायदे:
- मेंटेनेंस का काम कम करना पड़ता है.
- आपके ऐप्लिकेशन के नए वर्शन, पुराने मोबाइल ऑपरेटिंग सिस्टम पर चलने वाले उपयोगकर्ताओं के डिवाइसों के साथ ज़्यादा समय तक काम करते हैं. ऐसा तब तक होता है, जब तक आपको एसडीके के नए वर्शन पर अपग्रेड करने की ज़रूरत नहीं पड़ती.
प्रोजेक्ट के मालिकों को, उनके हर प्रोजेक्ट पर असर डालने वाले बदलावों के बारे में, पहले से सूचनाएं मिलती हैं. इसके लिए, वे ईमेल पते इस्तेमाल किए जाते हैं जिन पर नज़र रखी जाती है. अहम अपडेट, बंद होने वाली सुविधाओं, और अन्य बदलावों के बारे में जानकारी पाएं.
इंस्टॉलेशन
अपने ऐप्लिकेशन के लेवल की build.gradle.kts या build.gradle फ़ाइल में, हमेशा कोई वर्शन तय करें. इसके लिए, प्रीफ़िक्स रेंज (+) या latest का इस्तेमाल न करें. ऐसा इसलिए, क्योंकि इनकी वजह से ऐसे बिल्ड बन सकते हैं जिनके बारे में अनुमान नहीं लगाया जा सकता और जिन्हें दोहराया नहीं जा सकता. Places SDK for Android, सिमैंटिक वर्शनिंग के नियमों का पालन करता है. साथ ही, नए मुख्य वर्शन की रिलीज़ में, पुराने वर्शन के साथ काम न करने वाले बदलाव शामिल हो सकते हैं. कम से कम एपीआई लेवल 24 होना चाहिए.
dependencies { // Places and Maps SDKs implementation("com.google.android.libraries.places:places:5.1.1") }
मेंटेनेंस और अपग्रेड करना
Android Studio, उपलब्ध नए वर्शन की अपने-आप जांच करता है. साथ ही, किसी डिपेंडेंसी का नया वर्शन उपलब्ध होने पर, चेतावनी दिखाता है. तकनीकी कर्ज़ को कम करने के लिए, उपलब्ध सबसे नए वर्शन पर जल्द से जल्द अपडेट करें. अगर किसी नए मुख्य वर्शन पर अपडेट किया जा रहा है, पुराने वर्शन के साथ काम न करने वाले बदलावों और अपने कोड को अपडेट करने के तरीके के बारे में जानने के लिए, रिलीज़ नोट देखें.
Google Cloud प्रोजेक्ट मालिकों को, नए वर्शन के बारे में जानकारी पाने के अलावा, पुराने वर्शन के साथ काम न करने वाले ऐसे बदलावों के बारे में भी ईमेल मिलते हैं जिनसे उनके प्रोजेक्ट पर असर पड़ सकता है. पुराने वर्शन के साथ काम न करने वाले बदलावों के बारे में, पहले से सूचना पाने के लिए, अपने हर प्रोजेक्ट के लिए, मालिक की भूमिका असाइन करें. इसके लिए, ऐसे ईमेल पते का इस्तेमाल करें जिन पर नज़र रखी जाती है.
अगर Places SDK for Android के वर्शन 3.2.0 या इससे पहले के वर्शन से अपग्रेड किया जा रहा है
नए एसडीके पर माइग्रेट करने के लिए, किसी कार्रवाई की ज़रूरत नहीं है. आपको सिर्फ़ ये काम करने होंगे:
- अपने ऐप्लिकेशन में इस्तेमाल की गई एपीआई कुंजी पर, Places API (नया) चालू करें. ज़्यादा जानकारी के लिए, एपीआई कुंजियों का इस्तेमाल करना लेख पढ़ें.
अपने मॉड्यूल के लेवल की
dependenciesफ़ाइल केbuild.gradleसेक्शन में,placesडिपेंडेंसी को अपडेट करें औरkotlin-bomडिपेंडेंसी जोड़ें:dependencies { implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0")) implementation 'com.google.android.libraries.places:places:3.5.0' }
kotlin-bomडिपेंडेंसी के बारे में ज़्यादा जानने के लिए, ट्रांज़िटिव डिपेंडेंसी में kotlin-stdlib के सबसे नए वर्शन का इस्तेमाल करना लेख पढ़ें.- अपने ऐप्लिकेशन को शुरू करने के लिए, मौजूदा ऐप्लिकेशन को अपडेट करें, ताकि वह नए
Places.initializeWithNewPlacesApiEnabled()तरीके का इस्तेमाल कर सके. ज़्यादा जानकारी के लिए, Places API क्लाइंट को शुरू करना लेख पढ़ें.
आपके मौजूदा ऐप्लिकेशन, बिना किसी बदलाव के काम करते रहेंगे. हालांकि, अब एसडीके की सभी नई सुविधाओं का फ़ायदा लिया जा सकता है.