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

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

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

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

    फ़ायदे:

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

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

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

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

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

  1. Xcode में, File > Packages > Update To Latest Package Versions पर जाएं.
  2. इंस्टॉलेशन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. इससे पैकेज और उसके वर्शन की पुष्टि की जा सकेगी.

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

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

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 को चुनकर, अपने प्रोजेक्ट को हटाएं और फिर से बनाएं

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

सोर्स फ़ाइलों के नए वर्शन का लिंक पाने के लिए, Installing the SDK पर जाएं.

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