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

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

किस वर्शन को लिंक करें?

• मिशन-क्रिटिकल ऐप्लिकेशन के लिए, इस्तेमाल किए जा रहे मेजर वर्शन (X.*) के सबसे नए डॉट वर्शन को लिंक करें. साथ ही, हर साल नए मेजर वर्शन पर अपग्रेड करें.

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

  फ़ायदे:

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

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

  फ़ायदे:

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

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

इंस्टॉल करने की सुविधा

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

**ध्यान दें:** iOS के लिए Driver SDK, Carthage का इस्तेमाल करके इंस्टॉल नहीं किया जा सकता.

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 की मदद से इंस्टॉल किया जा सकता है. एसडीके जोड़ने के लिए, पक्का करें कि आपने Driver SDK की पहले से मौजूद सभी डिपेंडेंसी हटा दी हों.

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

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

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

1. Xcode में, फ़ाइल > पैकेज > पैकेज के सबसे नए वर्शन पर अपडेट करें पर जाएं.
2. इंस्टॉल करने की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन में जाकर, पैकेज और उसके वर्शन की पुष्टि करें.

अहम जानकारी: कभी-कभी, आर्टफ़ैक्ट को हल नहीं किया जा सकता या गड़बड़ियां हो सकती हैं. ऐसे में, "फ़ाइल > पैकेज > पैकेज का कैश रीसेट करें" को चुनें.

मेंटेनेंस और अपग्रेड करना

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

Cocoapods

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

   cd <path-to-project>

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

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

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

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