Google Maps Platform की टीम, एसडीके को समय-समय पर अपडेट करती रहती है. इनमें नई सुविधाएं जोड़ी जाती हैं, गड़बड़ियां ठीक की जाती हैं, और परफ़ॉर्मेंस को बेहतर बनाया जाता है. इस पेज पर, मोबाइल एसडीके पर अपनी डिपेंडेंसी मैनेज करने का तरीका बताया गया है.
किस वर्शन को लिंक करना है?
-
मिशन के लिए ज़रूरी ऐप्लिकेशन के लिए, उस मुख्य वर्शन (X.*) की सबसे नई डॉट रिलीज़ से लिंक करें जिसका इस्तेमाल किया जा रहा है. साथ ही, हर साल नए मुख्य वर्शन पर अपग्रेड करें.
साल भर में अपने ऐप्लिकेशन के नए वर्शन रिलीज़ करते समय, Maps SDK for Android के नए डॉट वर्शन का इस्तेमाल किया जा सकता है. इसके लिए, आपको अपने ऐप्लिकेशन में अपडेट करने की ज़रूरत नहीं होगी, क्योंकि नए डॉट वर्शन पिछले वर्शन के साथ काम करते हैं.
फ़ायदे:
- अगर आपको Android के लिए Maps SDK में समस्याएं मिलती हैं, तो उन्हें ठीक करने के लिए, मोबाइल डिवाइसों के लिए सहायता से जुड़ी नीति के मुताबिक, मुख्य वर्शन की शुरुआती रिलीज़ के 12 महीनों तक, पिछले वर्शन के साथ काम करने वाले तरीके से ठीक किया जाएगा. गड़बड़ियों को ठीक करने के लिए, आपको तुरंत काम न करने वाले एसडीके वर्शन पर अपग्रेड करने की ज़रूरत नहीं होगी.
- अगर आपका ऐप्लिकेशन पहले से ही नए वर्शन पर बना है, तो नई सुविधाओं और सुधारों को आसानी से लागू किया जा सकता है.
- एसडीके के सबसे नए वर्शन में हर साल होने वाले अपडेट को लागू करने के लिए, आपको अपने ऐप्लिकेशन में कम बदलाव करने पड़ सकते हैं. साथ ही, आपको ऐप्लिकेशन को फिर से लिखने और उसकी जांच करने में भी कम समय लग सकता है. ऐसा इसलिए, क्योंकि आपको एसडीके के कई वर्शन में हुए ऐसे बदलावों को लागू नहीं करना होगा जो पिछले वर्शन के साथ काम नहीं करते.
ज़रूरी न होने वाले ऐप्लिकेशन के लिए, किसी भी ऐसे वर्शन का लिंक दें जिसमें समस्या ठीक कर दी गई हो. जब आपको उस तय किए गए वर्शन के लिए, बंद होने की सूचना मिलती है, तो आपके पास 12 महीने का समय होता है. इस दौरान, आपको अपने उपयोगकर्ताओं के लिए, ऐप्लिकेशन के अपडेट किए गए कोड को उपलब्ध कराना होगा.
फ़ायदे:
- रखरखाव का काम कम बार करना पड़ता है.
- आपके ऐप्लिकेशन के नए वर्शन, पुराने मोबाइल ऑपरेटिंग सिस्टम पर काम करने वाले उपयोगकर्ताओं के डिवाइसों पर लंबे समय तक काम करते रहते हैं. ऐसा तब तक होता है, जब तक आपको एसडीके के नए वर्शन पर अपग्रेड करने की ज़रूरत नहीं पड़ती.
जिन प्रोजेक्ट के मालिकों ने अपने ईमेल पते मॉनिटर किए हैं उन्हें उन बदलावों के बारे में सूचनाएं मिलती हैं जिनसे उनके हर प्रोजेक्ट पर असर पड़ता है. बड़े अपडेट, सेवा में न रहने वाले एट्रिब्यूट, और अन्य बदलावों के बारे में अपडेट रहें.
इंस्टॉल करना
अपने ऐप्लिकेशन-लेवल की build.gradle.kts या build.gradle फ़ाइल में, हमेशा प्रीफ़िक्स रेंज (+) या latest के बजाय वर्शन तय करें. ऐसा इसलिए, क्योंकि इससे अप्रत्याशित और दोहराई न जा सकने वाली बिल्ड बन सकती हैं. Android के लिए Maps SDK, सिमैंटिक वर्शनिंग का पालन करता है. साथ ही, नए मुख्य वर्शन रिलीज़ में ऐसे बदलाव शामिल हो सकते हैं जो मौजूदा वर्शन के साथ काम नहीं करते. यह सुविधा, कम से कम एपीआई लेवल 21 पर काम करती है.
Gradle सिंटैक्स का इस्तेमाल करके, Google Play services में Maps की डिपेंडेंसी तय करना.
dependencies { // Maps SDK for Android implementation(libs.play.services.maps) }
Google Play services के वर्शन मैनेज करने के बारे में ज़्यादा जानकारी देखें.
रखरखाव और अपग्रेड करना
Android Studio, उपलब्ध नए वर्शन की अपने-आप जांच करता है. साथ ही, किसी डिपेंडेंसी का नया वर्शन उपलब्ध होने पर चेतावनी देता है. तकनीकी समस्याओं को कम करने के लिए, उपलब्ध सबसे नए वर्शन पर जल्द से जल्द अपडेट करें. अगर आपको किसी नए मुख्य वर्शन पर अपडेट करना है, तो रिलीज़ नोट देखें. इनमें पिछले वर्शन के साथ काम न करने वाले बदलावों और अपने कोड को अपडेट करने के तरीके के बारे में जानकारी दी गई है.
नए वर्शन के लिए पोलिंग के अलावा, Google Cloud प्रोजेक्ट के मालिकों को ऐसे बदलावों के बारे में ईमेल मिलते हैं जो पुराने वर्शन के साथ काम नहीं करते. इससे उनके प्रोजेक्ट पर असर पड़ सकता है. पिछले वर्शन के साथ काम न करने वाले बदलावों के बारे में पहले से सूचना पाने के लिए, अपने हर प्रोजेक्ट के लिए, मॉनिटर किए गए ईमेल पते के साथ मालिक की भूमिका असाइन करें.