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

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

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

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

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

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

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

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

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

Cocoapods

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

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

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

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

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