Google Maps Platform की टीम, एसडीके को समय-समय पर अपडेट करती रहती है. इनमें नई सुविधाएं जोड़ी जाती हैं, गड़बड़ियां ठीक की जाती हैं, और परफ़ॉर्मेंस को बेहतर बनाया जाता है. इस पेज पर, मोबाइल एसडीके पर अपनी डिपेंडेंसी मैनेज करने के तरीके के बारे में दिशा-निर्देश दिए गए हैं.
किस वर्शन से लिंक करना है?
-
मिशन के लिए ज़रूरी ऐप्लिकेशन के लिए, उस मुख्य वर्शन (X.*) की सबसे नई डॉट रिलीज़ से लिंक करें जिसका इस्तेमाल किया जा रहा है. साथ ही, हर साल नए मुख्य वर्शन पर अपग्रेड करें.
साल भर में अपने ऐप्लिकेशन के नए वर्शन रिलीज़ करते समय, iOS के लिए Places SDK के नए डॉट वर्शन का इस्तेमाल किया जा सकता है. इसके लिए, आपको अपने ऐप्लिकेशन में अपडेट करने की ज़रूरत नहीं होगी, क्योंकि नए डॉट वर्शन पिछले वर्शन के साथ काम करते हैं.
फ़ायदे:
- अगर आपको iOS के लिए Places SDK में समस्याएं मिलती हैं, तो उन्हें ठीक करने के लिए, मोबाइल सहायता से जुड़ी नीति के मुताबिक, मेजर वर्शन की शुरुआती रिलीज़ के बाद 12 महीनों तक, बैकवर्ड-कंपैटिबल तरीके से समाधान उपलब्ध कराए जाएंगे. गड़बड़ियों को ठीक करने के लिए, आपको काम न करने वाले एसडीके वर्शन पर तुरंत अपग्रेड करने की ज़रूरत नहीं होगी.
- अगर आपका ऐप्लिकेशन पहले से ही नए वर्शन पर बना है, तो नई सुविधाओं और सुधारों को आसानी से लागू किया जा सकता है.
- एसडीके के सबसे नए मेजर वर्शन में हर साल होने वाले अपडेट को लागू करने के लिए, आपको अपने ऐप्लिकेशन में कम बदलाव करने पड़ सकते हैं. साथ ही, उसे फिर से लिखने और टेस्ट करने में भी कम समय लग सकता है. ऐसा इसलिए, क्योंकि आपको एसडीके के कई मेजर वर्शन में हुए ऐसे बदलावों को लागू नहीं करना होगा जो पिछले वर्शन के साथ काम नहीं करते.
ज़रूरी न होने वाले ऐप्लिकेशन के लिए, किसी भी ऐसे वर्शन का लिंक दें जिसमें समस्या ठीक कर दी गई हो. जब आपको उस तय किए गए वर्शन के लिए, बंद होने की सूचना मिलती है, तो आपके पास 12 महीने का समय होता है. इस दौरान, आपको अपने उपयोगकर्ताओं के लिए, ऐप्लिकेशन के अपडेट किए गए कोड को उपलब्ध कराना होगा.
फ़ायदे:
- रखरखाव का काम कम बार करना पड़ता है.
- आपके ऐप्लिकेशन के नए वर्शन, पुराने मोबाइल ऑपरेटिंग सिस्टम पर काम करने वाले उपयोगकर्ताओं के डिवाइसों पर लंबे समय तक काम करते रहते हैं. ऐसा तब तक होता है, जब तक आपको एसडीके के नए वर्शन पर अपग्रेड करने की ज़रूरत नहीं पड़ती.
जिन प्रोजेक्ट के मालिकों ने अपने ईमेल पते मॉनिटर किए हैं उन्हें उन बदलावों के बारे में सूचनाएं मिलती हैं जिनसे उनके हर प्रोजेक्ट पर असर पड़ता है. अहम अपडेट, सेवा में न रहने वाले एट्रिब्यूट, और अन्य बदलावों के बारे में अपडेट रहें.
इंस्टॉल करना
Swift Package Manager
Places SDK for iOS को Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. एसडीके जोड़ने के लिए, पक्का करें कि आपने Places SDK for iOS की सभी मौजूदा डिपेंडेंसी हटा दी हों.
किसी नए या मौजूदा प्रोजेक्ट में SDK टूल जोड़ने के लिए, यह तरीका अपनाएं:
-
Xcode
projectयाworkspaceखोलें. इसके बाद, File > Add Package Dependencies पर जाएं. - यूआरएल के तौर पर https://github.com/googlemaps/ios-places-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "Add Package" पर क्लिक करें.
-
किसी खास
versionको इंस्टॉल करने के लिए, Dependency Rule फ़ील्ड को वर्शन के आधार पर उपलब्ध विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप सबसे नया वर्शन डालें और "Exact Version" विकल्प का इस्तेमाल करें. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें. - पैकेज प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि
GooglePlaces,GooglePlacesSwiftया दोनों को आपके चुने गए मुख्य टारगेट में जोड़ा जाएगा. यह चरण पूरा होने के बाद, पैकेज जोड़ें पर क्लिक करें.अगर आपको Google Places Swift को बंद किए गए GitHub यूआरएल से अपडेट करना है
अहम जानकारी: Google Places Swift को ऐक्सेस करने के लिए, GitHub का यूआरएल बदल गया है. यह बदलाव वर्शन 0.3.0 से लागू हुआ है. अगर आपको GooglePlacesSwift के ऐसे वर्शन को अपडेट करना है जिसे पुराने यूआरएल
https://github.com/googlemaps/ios-places-swift-sdkसे ऐक्सेस किया गया था, तो उसे Xcode के पैकेज डिपेंडेंसी सेक्शन से हटाएं. - इंस्टॉलेशन की पुष्टि करने के लिए, टारगेट के सामान्य पैनल पर जाएं. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन को भी देखा जा सकता है.
किसी मौजूदा प्रोजेक्ट के लिए package अपडेट करने के लिए, यह तरीका अपनाएं:
-
Xcode में, File > Packages > Update To Latest Package Versions पर जाएं.
अगर आपको Google Places Swift को बंद किए गए GitHub यूआरएल से अपडेट करना है
अहम जानकारी: Google Places Swift को ऐक्सेस करने के लिए, GitHub का यूआरएल बदल गया है. यह बदलाव वर्शन 0.3.0 से लागू हुआ है. अगर आपको GooglePlacesSwift के ऐसे वर्शन को अपडेट करना है जिसे पुराने यूआरएल
https://github.com/googlemaps/ios-places-swift-sdkसे ऐक्सेस किया गया था, तो उसे Xcode के पैकेज डिपेंडेंसी सेक्शन से हटाएं. - इंस्टॉल किए गए पैकेज की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. यहां पैकेज और उसके वर्शन की पुष्टि करें.
रखरखाव और अपग्रेड करना
नए सुधारों के साथ काम करने के लिए, समय-समय पर नए वर्शन देखें और अपने वर्शन के स्पेसिफ़िकेशन अपडेट करें. अगर आपको किसी नए मेजर वर्शन पर अपडेट करना है, तो पीछे की ओर काम न करने वाले बदलावों और अपने कोड को अपडेट करने के तरीके के बारे में जानने के लिए, प्रॉडक्ट की जानकारी देखें.
Swift Package Manager
किसी मौजूदा प्रोजेक्ट के लिए package अपडेट करने के लिए, यह तरीका अपनाएं:
- इंस्टॉल किए गए पैकेज की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. यहां पैकेज और उसके वर्शन की पुष्टि करें.
मैन्युअल तरीके से इंस्टॉल करना
Google Cloud प्रोजेक्ट के मालिकों को, नए वर्शन के लिए पोलिंग के अलावा, ऐसे बदलावों के बारे में ईमेल भी मिलते हैं जो पुराने वर्शन के साथ काम नहीं करते. इन बदलावों से उनके प्रोजेक्ट पर असर पड़ सकता है. पिछले वर्शन के साथ काम न करने वाले बदलावों के बारे में पहले से सूचना पाने के लिए, अपने हर प्रोजेक्ट के लिए, मॉनिटर किए गए ईमेल पते से मालिक की भूमिका असाइन करें.