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

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

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

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

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

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

  फ़ायदे:

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

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

  फ़ायदे:

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

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

इंस्टॉल करना

Swift Package Manager

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

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

1. Xcode project या workspace खोलें. इसके बाद, File > Add Package Dependencies पर जाएं.
2. यूआरएल के तौर पर https://github.com/googlemaps/ios-maps-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "Add Package" पर क्लिक करें.
3. कोई खास version इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन के हिसाब से उपलब्ध विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप नया वर्शन तय करें और "Exact Version" विकल्प का इस्तेमाल करें. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें.
4. Choose Package Products विंडो में जाकर, पुष्टि करें कि GoogleMaps को आपके तय किए गए टारगेट में जोड़ा जाएगा. अगर आपके पास 9.0.0 से पहले का वर्शन है, तो पुष्टि करें कि GoogleMaps, GoogleMapsBase, और GoogleMapsCore को आपके तय किए गए main टारगेट में जोड़ा जाएगा. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें.
5. इंस्टॉलेशन की पुष्टि करने के लिए, अपने टारगेट के सामान्य पैनल पर जाएं. Frameworks, Libraries, and Embedded Content में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, "प्रोजेक्ट नेविगेटर" के "पैकेज डिपेंडेंसी" सेक्शन को भी देखा जा सकता है.

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

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

   Xcode प्रोजेक्ट की कॉन्फ़िगरेशन सेटिंग में जाकर, Frameworks, Libraries, and Embedded Content ढूंढें. इस फ़्रेमवर्क को हटाने के लिए, माइनस के निशान(-) का इस्तेमाल करें:

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

अहम जानकारी: कभी-कभी, आर्टफ़ैक्ट को रिज़ॉल्व नहीं किया जा सकता या गड़बड़ियां हो सकती हैं. ऐसे में, "File > Packages > Reset Package Cache" को चुनें.

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 का इस्तेमाल नहीं किया जा रहा है, तो इन्हें हटा दें.

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

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

Swift Package Manager

To update the package for an existing project, follow these steps:

  

    
    
    

      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
  
  
  

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

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

सोर्स फ़ाइलों के नए वर्शन का लिंक पाने के लिए, Installing the SDK पर जाएं.

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