iOS वर्शन के लिए Maps SDK टूल

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

Google Maps Platform की टीम, SDK टूल को समय-समय पर अपडेट करती रहती है. इसमें नई सुविधाएं जोड़ी जाती हैं, गड़बड़ियां ठीक की जाती हैं, और परफ़ॉर्मेंस को बेहतर बनाया जाता है. इस पेज पर, मोबाइल एसडीके पर अपनी डिपेंडेंसी मैनेज करने का तरीका बताया गया है.

किस वर्शन से लिंक करना है?

• ज़रूरी ऐप्लिकेशन के लिए, इस्तेमाल किए जा रहे मुख्य वर्शन (X.*) के सबसे नए बिंदु वाले वर्शन से लिंक करें और हर साल नए मुख्य वर्शन पर अपग्रेड करें.

  साल भर अपने ऐप्लिकेशन के नए वर्शन रिलीज़ करने पर, iOS के लिए Maps SDK टूल के नए वर्शन का इस्तेमाल किया जा सकता है. इसके लिए, आपको अपने ऐप्लिकेशन में अपडेट करने की ज़रूरत नहीं होगी, क्योंकि नए बिंदु वाले वर्शन, पुराने वर्शन के साथ काम करते हैं.

  फ़ायदे:

  • अगर आपको iOS के लिए Maps SDK टूल में समस्याएं मिलती हैं, तो मोबाइल सपोर्ट नीति के मुताबिक, मेजर वर्शन के रिलीज़ होने के बाद 12 महीने तक, समस्याओं को ठीक करने के लिए, पुराने वर्शन के साथ काम करने वाला तरीका उपलब्ध कराया जाएगा. गड़बड़ियों को ठीक करने के लिए, आपको SDK टूल के काम न करने वाले वर्शन पर तुरंत अपग्रेड करने की ज़रूरत नहीं होगी.
  • अगर आपका ऐप्लिकेशन पहले से ही सबसे नए वर्शन पर बना है, तो नए सुधार और सुविधाओं को आसानी से अपनाया जा सकता है.
  • SDK टूल के नए वर्शन में हर साल होने वाले अपडेट के लिए, ऐप्लिकेशन को अडैप्ट करने, फिर से लिखने, और उसकी जांच करने में कम समय लग सकता है. ऐसा इसलिए, क्योंकि एक से ज़्यादा वर्शन रिलीज़ में किए गए बदलावों को पुराने वर्शन के साथ काम नहीं करना पड़ता.

• ऐसे ऐप्लिकेशन के लिए जिनमें कोई समस्या नहीं है, किसी भी ठीक किए गए वर्शन से लिंक करें. जब आपको उस ठीक किए गए वर्शन के लिए, इस्तेमाल बंद होने की सूचना मिलेगी, तो आपके पास अपने ऐप्लिकेशन का अपडेट किया गया कोड, उपयोगकर्ताओं के लिए उपलब्ध कराने के लिए 12 महीने होंगे.

  फ़ायदे:

  • रखरखाव का काम कम बार करना पड़ता है.
  • आपके ऐप्लिकेशन के नए वर्शन, उपयोगकर्ताओं के उन डिवाइसों पर लंबे समय तक काम करते रहते हैं जिनमें पुराने मोबाइल ऑपरेटिंग सिस्टम का इस्तेमाल किया जा रहा है. ऐसा तब तक होता है, जब तक आपको SDK टूल के नए वर्शन पर अपग्रेड नहीं करना पड़ता.

जिन प्रोजेक्ट के मालिकों के ईमेल पते मॉनिटर किए जाते हैं उन्हें उन बदलावों के बारे में पहले से सूचनाएं मिलती हैं जिनका उनके हर प्रोजेक्ट पर असर पड़ता है. बड़े अपडेट, बंद होने वाली सुविधाओं, और अन्य बदलावों के बारे में अप-टू-डेट रहें.

इंस्टॉल करना

Swift Package Manager

iOS के लिए Maps SDK टूल को Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. एसडीके टूल जोड़ने के लिए, पक्का करें कि आपने iOS के लिए Maps SDK टूल की सभी मौजूदा डिपेंडेंसी हटा दी हों.

अहम जानकारी: ये निर्देश, Xcode 15 या इसके बाद के वर्शन के लिए हैं. हालांकि, ये Xcode के पुराने वर्शन के लिए भी काम के हो सकते हैं.

किसी नए या मौजूदा प्रोजेक्ट में SDK टूल जोड़ने के लिए, यह तरीका अपनाएं:

1. Xcode project या workspace खोलें. इसके बाद, फ़ाइल > पैकेज की डिपेंडेंसी जोड़ें पर जाएं.
2. यूआरएल के तौर पर https://github.com/googlemaps/ios-maps-sdk डालें. इसके बाद, पैकेज को इंपोर्ट करने के लिए Enter दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
3. किसी खास version को इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन पर आधारित विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप "सटीक वर्शन" विकल्प का इस्तेमाल करके, सबसे नया वर्शन डालें. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें.

किसी मौजूदा प्रोजेक्ट के लिए package को अपडेट करने के लिए, यह तरीका अपनाएं:

1. अगर आपको 9.0.0 से पहले के वर्शन से अपग्रेड करना है, तो आपको अपग्रेड करने के बाद, इन डिपेंडेंसी को हटाना होगा: GoogleMapsBase, GoogleMapsCore, और GoogleMapsM4B. GoogleMaps के लिए डिपेंडेंसी न हटाएं. ज़्यादा जानकारी के लिए, 9.0.0 वर्शन के रिलीज़ नोट देखें.

   Xcode प्रोजेक्ट की कॉन्फ़िगरेशन सेटिंग में, फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट ढूंढें. नीचे दिए गए फ़्रेमवर्क को हटाने के लिए, माइनस के निशान(-) का इस्तेमाल करें:

   • GoogleMapsBase (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
   • GoogleMapsCore (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
   • GoogleMapsM4B (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
2. Xcode में, "फ़ाइल > पैकेज > पैकेज के नए वर्शन पर अपडेट करें" पर जाएं.
3. इंस्टॉल की पुष्टि करने के लिए, Project Navigator के पैकेज की डिपेंडेंसी सेक्शन पर जाएं और पैकेज और उसके वर्शन की पुष्टि करें.

अहम जानकारी: कभी-कभी, आर्टफ़ैक्ट ठीक नहीं हो पाते या गड़बड़ियां हो सकती हैं. ऐसे में, "फ़ाइल > पैकेज > पैकेज कैश मेमोरी रीसेट करें" को चुनें.

CocoaPods का इस्तेमाल करके जोड़ी गई, iOS के लिए Maps SDK की मौजूदा डिपेंडेंसी हटाने के लिए, यह तरीका अपनाएं:

1. अपना Xcode फ़ाइल फ़ोल्डर बंद करें. टर्मिनल खोलें और यह कमांड चलाएं:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. अगर CocoaPods के अलावा किसी और काम के लिए Podfile, Podfile.resolved, और Xcode workspace का इस्तेमाल नहीं किया जा रहा है, तो उन्हें हटा दें.

CocoaPods

ऑप्टिमिज़्म ऑपरेटर (~>) का इस्तेमाल करने के बजाय, अपनी डिपेंडेंसी में हमेशा वर्शन नंबर डालें. ऐसा इसलिए, क्योंकि इससे अनचाहे और दोहराए न जा सकने वाले बिल्ड बन सकते हैं. iOS के लिए Maps SDK टूल, सेमांटिक वर्शनिंग का पालन करता है. साथ ही, नए मेजर वर्शन की रिलीज़ में, ऐसे बदलाव शामिल होते हैं जो काम करने के तरीके में बदलाव करते हैं.

Podfile सिंटैक्स का इस्तेमाल करके, Podfile की डिपेंडेंसी का उदाहरण:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '9.2.0'
end

रखरखाव और अपग्रेड

नए वर्शन में किए गए सुधारों का इस्तेमाल करने के लिए, समय-समय पर नए वर्शन देखें और अपने वर्शन की जानकारी अपडेट करें. अगर आपको किसी नए वर्शन पर अपडेट करना है, तो रिलीज़ नोट देखें. इससे आपको पता चलेगा कि कौनसे बदलाव, पुराने वर्शन के साथ काम नहीं करते और कोड को अपडेट करने का तरीका क्या है.

Swift Package Manager

किसी मौजूदा प्रोजेक्ट के लिए package को अपडेट करने के लिए, यह तरीका अपनाएं:

1. इंस्टॉल की पुष्टि करने के लिए, Project Navigator के पैकेज की डिपेंडेंसी सेक्शन पर जाएं और पैकेज और उसके वर्शन की पुष्टि करें.

अहम जानकारी: कभी-कभी, आर्टफ़ैक्ट ठीक नहीं हो पाते या गड़बड़ियां हो सकती हैं. ऐसे में, "फ़ाइल > पैकेज > पैकेज कैश मेमोरी रीसेट करें" को चुनें.

Cocoapods

1. कोई टर्मिनल खोलें और उस डायरेक्ट्री पर जाएं जिसमें Podfile मौजूद है:

   cd <path-to-project>

2. pod outdated को चलाकर देखें कि iOS के लिए Maps SDK टूल का नया वर्शन उपलब्ध है या नहीं.
3. अगर SDK टूल का नया वर्शन मिलता है, तो अपने Podfile को इस नए वर्शन पर अपडेट करें. अपने Podfile में कोई खास वर्शन सेट करने का तरीका जानने के लिए, पॉड के वर्शन तय करना देखें.
4. pod update चलाएं.
5. अपग्रेड के बाद, ज़रूरी बदलाव करें. हर रिलीज़ में हुए बदलावों की सूची देखने के लिए, रिलीज़ नोट देखें.
6. प्रॉडक्ट > क्लीन करें को चुनकर, अपने प्रोजेक्ट को क्लीन और फिर से बनाएं. इसके बाद, प्रॉडक्ट > बिल्ड करें को चुनें

मैन्युअल तरीके से इंस्टॉल करना

SDK टूल इंस्टॉल करने के लिए, नई सोर्स फ़ाइलों का लिंक पाएं.

नए वर्शन के लिए पोलिंग के अलावा, Google Cloud के प्रोजेक्ट के मालिकों को ऐसे बदलावों के बारे में ईमेल मिलते हैं जो पुराने वर्शन के साथ काम नहीं करते. इन बदलावों से उनके प्रोजेक्ट पर असर पड़ सकता है. अगर आपको उन बदलावों के बारे में पहले से सूचना चाहिए जो पुराने वर्शन के साथ काम नहीं करते, तो अपने हर प्रोजेक्ट के लिए, निगरानी में रखे गए ईमेल पते के साथ मालिक की भूमिका असाइन करें.