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

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

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

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

• मकसद के अहम ऐप्लिकेशन के लिए, इस्तेमाल किए जा रहे मेजर वर्शन (X.*) के सबसे नए डॉट रिलीज़ को लिंक करें. साथ ही, हर साल नए मेजर वर्शन पर अपग्रेड करें.

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

  फ़ायदे:

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

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

  फ़ायदे:

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

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

इंस्टॉल करना

स्विफ़्ट पैकेज मैनेजर

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

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

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

1. अपना Xcode project या workspace खोलें. इसके बाद, फ़ाइल > पैकेज डिपेंडेंसी जोड़ें पर जाएं.
2. यूआरएल के तौर पर, https://github.com/googlemaps/ios-maps-sdk डालें. पैकेज पाने के लिए, Enter दबाएं, और "पैकेज जोड़ें" पर क्लिक करें.
3. किसी खास version को इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन-आधारित विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप सबसे नया वर्शन तय करें. साथ ही, "एग्ज़ैक्ट वर्शन" विकल्प इस्तेमाल करें. यह प्रोसेस पूरी होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.
4. पैकेज के प्रॉडक्ट चुनें विंडो से, पुष्टि करें कि GoogleMaps, GoogleMapsBase, और GoogleMapsCore को आपके तय किए गए main टारगेट में जोड़ दिया जाएगा. यह प्रोसेस पूरी होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.
5. अपने इंस्टॉलेशन की पुष्टि करने के लिए, अपने टारगेट के General पैनल पर जाएं. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किए गए कॉन्टेंट में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, "Project Navigator" के "पैकेज डिपेंडेंसी" सेक्शन में भी देखा जा सकता है.

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

1. Xcode से, "फ़ाइल > पैकेज > सबसे नए पैकेज वर्शन में अपडेट करें" पर जाएं.
2. अपने इंस्टॉलेशन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन में जाकर पैकेज और उसके वर्शन की पुष्टि करें.

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

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

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

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

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

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', '8.4.0'
end

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

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

स्विफ़्ट पैकेज मैनेजर

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

1. Xcode से, "फ़ाइल > पैकेज > सबसे नए पैकेज वर्शन में अपडेट करें" पर जाएं.
2. अपने इंस्टॉलेशन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन में जाकर पैकेज और उसके वर्शन की पुष्टि करें.

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

कोकोपॉड

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

   cd <path-to-project>

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

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

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

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