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:4.3.1") }
रखरखाव और अपग्रेड करना
Android Studio, उपलब्ध नए वर्शन की अपने-आप जांच करता है. साथ ही, किसी डिपेंडेंसी का नया वर्शन उपलब्ध होने पर चेतावनी देता है. तकनीकी समस्याओं को कम करने के लिए, उपलब्ध सबसे नए वर्शन पर जल्द से जल्द अपडेट करें. अगर आपको किसी नए मुख्य वर्शन पर अपडेट करना है, तो रिलीज़ नोट देखें और जानें कि पुराने वर्शन के साथ काम न करने वाले बदलाव कौनसे हैं और अपने कोड को कैसे अपडेट करें.
नए वर्शन के लिए पोलिंग के अलावा, Google Cloud प्रोजेक्ट के मालिकों को ऐसे बदलावों के बारे में ईमेल मिलते हैं जो पुराने वर्शन के साथ काम नहीं करते. इन बदलावों से उनके प्रोजेक्ट पर असर पड़ सकता है. पिछले वर्शन के साथ काम न करने वाले बदलावों के बारे में पहले से सूचना पाने के लिए, अपने हर प्रोजेक्ट के लिए, मॉनिटर किए गए ईमेल पते के साथ मालिक की भूमिका असाइन करें.
अगर Places SDK for Android के 3.2.0 या इससे पहले के वर्शन से अपग्रेड किया जा रहा है
नए SDK पर माइग्रेट करने के लिए, किसी कार्रवाई की ज़रूरत नहीं है. आपको सिर्फ़ ये काम करने होंगे:
- अपने ऐप्लिकेशन में इस्तेमाल की गई एपीआई कुंजी पर, 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 क्लाइंट को शुरू करना लेख पढ़ें.
आपके मौजूदा ऐप्लिकेशन पहले की तरह ही काम करते रहेंगे. हालांकि, अब आपको एसडीके की सभी नई सुविधाओं का फ़ायदा मिल सकता है.