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

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

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

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

    फ़ायदे:

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

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

    फ़ायदे:

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

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

इंस्टॉल करना

हमेशा अपनी डिपेंडेंसी में वर्शन नंबर डालें. इसके लिए, ऑप्टिमिस्टिक ऑपरेटर (~>) का इस्तेमाल न करें. ऐसा इसलिए, क्योंकि इससे ऐसे बिल्ड बन सकते हैं जिनके बारे में अनुमान नहीं लगाया जा सकता और जिन्हें दोहराया नहीं जा सकता. 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 खोलें. इसके बाद, File > Add Package Dependencies पर जाएं.
  2. यूआरएल के तौर पर https://github.com/googlemaps/ios-driver-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "Add Package" पर क्लिक करें.
  3. किसी खास version को इंस्टॉल करने के लिए, Dependency Rule फ़ील्ड को वर्शन के आधार पर उपलब्ध विकल्पों में से किसी एक पर सेट करें. हमारा सुझाव है कि नए प्रोजेक्ट के लिए, "Exact Version" विकल्प का इस्तेमाल करके, नए वर्शन के बारे में बताएं. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.

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

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

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

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

Cocoapods

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

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

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

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

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