iOS वर्शन के लिए ड्राइवर SDK टूल

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

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

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

    फ़ायदे:

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

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

    फ़ायदे:

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

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

इंस्टॉल करना

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

CocoaPods

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

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

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end
    

Swift पैकेज मैनेजर

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

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

  1. Xcode project या workspace खोलें. इसके बाद, फ़ाइल > पैकेज की डिपेंडेंसी जोड़ें पर जाएं.
  2. यूआरएल के तौर पर https://github.com/googlemaps/ios-driver-sdk डालें. इसके बाद, पैकेज को शामिल करने के लिए Enter दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
  3. किसी खास version को इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन पर आधारित विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप "सटीक वर्शन" विकल्प का इस्तेमाल करके, सबसे नया वर्शन डालें. यह प्रोसेस पूरी होने के बाद, "Add Package" पर क्लिक करें.

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

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

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

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

कोकोपॉड

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

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

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

SDK टूल इंस्टॉल करते समय सबसे नई सोर्स फ़ाइलों का लिंक पाएं.

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