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

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

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

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

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

    फ़ायदे:

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

  • ज़रूरी न होने वाले ऐप्लिकेशन के लिए, किसी भी ऐसे वर्शन का लिंक दें जिसमें समस्या ठीक कर दी गई हो. जब आपको उस तय किए गए वर्शन के लिए, बंद होने की सूचना मिलती है, तो आपके पास 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 को इंस्टॉल करने के लिए, Dependency Rule फ़ील्ड को वर्शन के आधार पर उपलब्ध विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप सबसे नया वर्शन डालें और "Exact Version" विकल्प का इस्तेमाल करें. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.
  4. Choose Package Products विंडो में जाकर, पुष्टि करें कि GoogleMaps (9.0.0 से पहले के वर्शन के लिए, पुष्टि करें कि GoogleMaps, GoogleMapsBase, और GoogleMapsCore) को आपके चुने गए main टारगेट में जोड़ दिया जाएगा. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.
  5. इंस्टॉलेशन की पुष्टि करने के लिए, टारगेट के सामान्य पैनल पर जाएं. आपको फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में इंस्टॉल किए गए पैकेज दिखने चाहिए. पैकेज और उसके वर्शन की पुष्टि करने के लिए, "प्रोजेक्ट नेविगेटर" के "पैकेज डिपेंडेंसी" सेक्शन को भी देखा जा सकता है.

किसी मौजूदा प्रोजेक्ट के लिए 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. इंस्टॉल किए गए पैकेज की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. यहां पैकेज और उसके वर्शन की पुष्टि करें.

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

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

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

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

एसडीके इंस्टॉल करने के लिए, सोर्स फ़ाइलों का नया लिंक पाएं.

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