Google Maps Platform की टीम, SDK टूल को समय-समय पर अपडेट करती रहती है. इसमें नई सुविधाएं जोड़ी जाती हैं, गड़बड़ियां ठीक की जाती हैं, और परफ़ॉर्मेंस को बेहतर बनाया जाता है. इस पेज पर, मोबाइल एसडीके पर अपनी डिपेंडेंसी मैनेज करने का तरीका बताया गया है.
किस वर्शन से लिंक करना है?
-
ज़रूरी ऐप्लिकेशन के लिए, इस्तेमाल किए जा रहे मुख्य वर्शन (X.*) के सबसे नए बिंदु वाले वर्शन से लिंक करें और हर साल नए मुख्य वर्शन पर अपग्रेड करें.
साल भर अपने ऐप्लिकेशन के नए वर्शन रिलीज़ करने पर, iOS के लिए Places SDK टूल के नए वर्शन का इस्तेमाल किया जा सकता है. इसके लिए, आपको अपने ऐप्लिकेशन में अपडेट करने की ज़रूरत नहीं होगी, क्योंकि नए बिंदु वाले वर्शन, पुराने वर्शन के साथ काम करते हैं.
फ़ायदे:
- अगर आपको Places SDK for iOS में समस्याएं मिलती हैं, तो मोबाइल सपोर्ट नीति के मुताबिक, मेजर वर्शन के रिलीज़ होने के बाद 12 महीनों तक, समस्याओं को ठीक करने के लिए, पुराने वर्शन के साथ काम करने वाला तरीका उपलब्ध कराया जाएगा. गड़बड़ियों को ठीक करने के लिए, आपको SDK टूल के काम न करने वाले वर्शन पर तुरंत अपग्रेड करने की ज़रूरत नहीं होगी.
- अगर आपका ऐप्लिकेशन पहले से ही सबसे नए वर्शन पर बना है, तो नए सुधार और सुविधाओं को आसानी से अपनाया जा सकता है.
- SDK टूल के नए वर्शन में हर साल होने वाले अपडेट के लिए, ऐप्लिकेशन को अडैप्ट करने, फिर से लिखने, और उसकी जांच करने में कम समय लग सकता है. ऐसा इसलिए, क्योंकि एक से ज़्यादा वर्शन रिलीज़ में किए गए बदलावों को पुराने वर्शन के साथ काम नहीं करना पड़ता.
ऐसे ऐप्लिकेशन के लिए जिनमें कोई समस्या नहीं है, किसी भी ठीक किए गए वर्शन से लिंक करें. जब आपको उस ठीक किए गए वर्शन के लिए, इस्तेमाल बंद होने की सूचना मिलेगी, तो आपके पास अपने ऐप्लिकेशन का अपडेट किया गया कोड, उपयोगकर्ताओं के लिए उपलब्ध कराने के लिए 12 महीने होंगे.
फ़ायदे:
- रखरखाव का काम कम बार करना पड़ता है.
- आपके ऐप्लिकेशन के नए वर्शन, उपयोगकर्ताओं के उन डिवाइसों पर लंबे समय तक काम करते रहते हैं जिनमें पुराने मोबाइल ऑपरेटिंग सिस्टम का इस्तेमाल किया जा रहा है. ऐसा तब तक होता है, जब तक आपको SDK टूल के नए वर्शन पर अपग्रेड नहीं करना पड़ता.
जिन प्रोजेक्ट के मालिकों के ईमेल पते मॉनिटर किए जाते हैं उन्हें उन बदलावों के बारे में पहले से सूचनाएं मिलती हैं जिनका उनके हर प्रोजेक्ट पर असर पड़ता है. बड़े अपडेट, बंद होने वाली सुविधाओं, और अन्य बदलावों के बारे में अप-टू-डेट रहें.
इंस्टॉल करना
Swift Package Manager
iOS के लिए Places SDK टूल को Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. एसडीके जोड़ने के लिए, पक्का करें कि आपने Places SDK for iOS की सभी मौजूदा डिपेंडेंसी हटा दी हों.
किसी नए या मौजूदा प्रोजेक्ट में SDK टूल जोड़ने के लिए, यह तरीका अपनाएं:
-
Xcode
projectयाworkspaceखोलें. इसके बाद, फ़ाइल > पैकेज की डिपेंडेंसी जोड़ें पर जाएं. - यूआरएल के तौर पर https://github.com/googlemaps/ios-places-sdk डालें. इसके बाद, पैकेज को इंपोर्ट करने के लिए Enter दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
-
किसी खास
versionको इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन पर आधारित विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप "सटीक वर्शन" विकल्प का इस्तेमाल करके, सबसे नया वर्शन डालें. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें. - पैकेज के प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि आपके तय किए गए मुख्य टारगेट में
GooglePlaces,GooglePlacesSwiftया दोनों को जोड़ा जाएगा. इसके बाद, पैकेज जोड़ें पर क्लिक करें.Google Places Swift को अपडेट करने पर
अहम जानकारी: Google Places Swift को ऐक्सेस करने के लिए, GitHub का यूआरएल 0.3.0 वर्शन से बदल गया है. अगर आपको GooglePlacesSwift के उस वर्शन को अपडेट करना है जिसे पुराने यूआरएल,
https://github.com/googlemaps/ios-places-swift-sdkसे ऐक्सेस किया गया था, तो उसे Xcode के पैकेज डिपेंडेंसी सेक्शन से हटाएं. - इंस्टॉलेशन की पुष्टि करने के लिए, अपने टारगेट के सामान्य पैनल पर जाएं. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, Project Navigator के पैकेज की डिपेंडेंसी सेक्शन को भी देखा जा सकता है. Xcode, GitHub वर्शन दिखाता है, जो GooglePlaces के वर्शन (उदाहरण के लिए, 9.2.0) से मेल खाता है, लेकिन GooglePlacesSwift के वर्शन (उदाहरण के लिए, 0.3.0) से मेल नहीं खाता.
किसी मौजूदा प्रोजेक्ट के लिए package को अपडेट करने के लिए, यह तरीका अपनाएं:
-
Xcode में, "फ़ाइल > पैकेज > पैकेज के नए वर्शन पर अपडेट करें" पर जाएं.
Google Places Swift को अपडेट करने पर
अहम जानकारी: Google Places Swift को ऐक्सेस करने के लिए, GitHub का यूआरएल 0.3.0 वर्शन से बदल गया है. अगर आपको GooglePlacesSwift के उस वर्शन को अपडेट करना है जिसे पुराने यूआरएल,
https://github.com/googlemaps/ios-places-swift-sdkसे ऐक्सेस किया गया था, तो उसे Xcode के पैकेज डिपेंडेंसी सेक्शन से हटाएं. - इंस्टॉल की पुष्टि करने के लिए, Project Navigator के पैकेज की डिपेंडेंसी सेक्शन पर जाएं और पैकेज और उसके वर्शन की पुष्टि करें.
CocoaPods
ऑप्टिमिज़्म ऑपरेटर (~>) का इस्तेमाल करने के बजाय, अपनी डिपेंडेंसी में हमेशा वर्शन नंबर डालें. ऐसा इसलिए, क्योंकि इससे अनचाहे और दोहराए न जा सकने वाले बिल्ड बन सकते हैं. iOS के लिए Places SDK टूल, सेमांटिक वर्शनिंग का पालन करता है. साथ ही, नए मेजर वर्शन की रिलीज़ में, काम न करने वाले बदलाव शामिल होते हैं.
Podfile सिंटैक्स का इस्तेमाल करके, Podfile की डिपेंडेंसी का उदाहरण:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GooglePlaces', '9.2.0' pod 'GooglePlacesSwift', '0.3.0' end
रखरखाव और अपग्रेड
नए वर्शन में किए गए सुधारों का इस्तेमाल करने के लिए, समय-समय पर नए वर्शन देखें और अपने वर्शन की जानकारी अपडेट करें. अगर आपको किसी नए वर्शन पर अपडेट करना है, तो रिलीज़ नोट देखें. इससे आपको पता चलेगा कि कौनसे बदलाव, पुराने वर्शन के साथ काम नहीं करते और कोड को अपडेट करने का तरीका क्या है.
Swift Package Manager
किसी मौजूदा प्रोजेक्ट के लिए package को अपडेट करने के लिए, यह तरीका अपनाएं:
- इंस्टॉल की पुष्टि करने के लिए, Project Navigator के पैकेज की डिपेंडेंसी सेक्शन पर जाएं और पैकेज और उसके वर्शन की पुष्टि करें.
Cocoapods
कोई टर्मिनल खोलें और उस डायरेक्ट्री पर जाएं जिसमें
Podfileमौजूद है:cd <path-to-project>
pod outdatedचलाकर देखें कि Places SDK for iOS का नया वर्शन उपलब्ध है या नहीं.- अगर SDK टूल का नया वर्शन मिलता है, तो अपने
Podfileको इस नए वर्शन पर अपडेट करें. अपनेPodfileमें कोई खास वर्शन सेट करने का तरीका जानने के लिए, पॉड के वर्शन तय करना देखें. pod updateचलाएं.- अपग्रेड के बाद, ज़रूरी बदलाव करें. हर रिलीज़ में हुए बदलावों की सूची देखने के लिए, रिलीज़ नोट देखें.
- प्रॉडक्ट > क्लीन करें को चुनकर, अपने प्रोजेक्ट को क्लीन और फिर से बनाएं. इसके बाद, प्रॉडक्ट > बिल्ड करें को चुनें
मैन्युअल तरीके से इंस्टॉल करना
SDK टूल इंस्टॉल करने के लिए, नई सोर्स फ़ाइलों का लिंक पाएं.
नए वर्शन के लिए पोलिंग के अलावा, Google Cloud के प्रोजेक्ट के मालिकों को ऐसे बदलावों के बारे में ईमेल मिलते हैं जो पुराने वर्शन के साथ काम नहीं करते. इन बदलावों से उनके प्रोजेक्ट पर असर पड़ सकता है. अगर आपको उन बदलावों के बारे में पहले से सूचना चाहिए जो पुराने वर्शन के साथ काम नहीं करते, तो अपने हर प्रोजेक्ट के लिए, निगरानी में रखे गए ईमेल पते के साथ मालिक की भूमिका असाइन करें.