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

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

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

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

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

    फ़ायदे:

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

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

    फ़ायदे:

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

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

इंस्टॉल करना

Swift Package Manager

Maps SDK for iOS को 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" विकल्प का इस्तेमाल करके, नए वर्शन के बारे में बताएं. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.

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

CocoaPods

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

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

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

platform :ios, '16.0'

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

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

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

Swift Package Manager

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

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

Cocoapods

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

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

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

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

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