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