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

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

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

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

    फ़ायदे:

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

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

    फ़ायदे:

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

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

इंस्टॉल करना

ऑप्टिमिस्ट ऑपरेटर (~>) का इस्तेमाल करने के बजाय, अपनी डिपेंडेंसी में हमेशा वर्शन नंबर डालें. ऐसा इसलिए, क्योंकि इससे अनचाहे और दोहराए न जा सकने वाले बिल्ड बन सकते हैं. iOS के लिए Driver 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 Package Manager

Driver SDK टूल को Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. 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 के प्रोजेक्ट के मालिकों को ऐसे बदलावों के बारे में ईमेल मिलते हैं जो पुराने वर्शन के साथ काम नहीं करते. इन बदलावों से उनके प्रोजेक्ट पर असर पड़ सकता है. अगर आपको उन बदलावों के बारे में पहले से सूचना चाहिए जो पुराने वर्शन के साथ काम नहीं करते, तो अपने हर प्रोजेक्ट के लिए, निगरानी में रखे गए ईमेल पते के साथ मालिक की भूमिका असाइन करें.