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 दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
  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

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

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

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

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '10.1.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 प्रोजेक्ट के मालिकों को ऐसे बदलावों के बारे में ईमेल मिलते हैं जो पुराने वर्शन के साथ काम नहीं करते. इन बदलावों से उनके प्रोजेक्ट पर असर पड़ सकता है. पिछले वर्शन के साथ काम न करने वाले बदलावों के बारे में पहले से सूचना पाने के लिए, अपने हर प्रोजेक्ट के लिए, मॉनिटर किए गए ईमेल पते के साथ मालिक की भूमिका असाइन करें.