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

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

किस वर्शन से लिंक करना है?

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

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

  फ़ायदे:

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

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

  फ़ायदे:

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

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

इंस्टॉल करना

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

ध्यान दें: iOS के लिए ड्राइवर 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 पैकेज मैनेजर

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

अहम जानकारी: ये निर्देश Xcode 15 या इसके बाद के वर्शन के इस्तेमाल के बारे में हैं. हालांकि, ये Xcode के पिछले वर्शन के जैसे ही होने चाहिए.

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

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

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

1. अगर आपने 9.0.0 से पहले के वर्शन से अपग्रेड किया है, तो अपग्रेड करने के बाद आपको ये डिपेंडेंसी हटानी होंगी: GoogleMapsBase, GoogleMapsCore, और GoogleMapsM4B. GoogleMaps के लिए डिपेंडेंसी न हटाएं. ज़्यादा जानकारी के लिए, वर्शन 9.0.0 के बारे में जानकारी देखें.

   अपने Xcode प्रोजेक्ट की कॉन्फ़िगरेशन सेटिंग में फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट ढूंढें. नीचे दिए गए फ़्रेमवर्क को हटाने के लिए, माइनस साइन(-) का इस्तेमाल करें:

   • GoogleMapsBase (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
   • GoogleMapsCore (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
   • GoogleMapsM4B (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
2. Xcode से, "फ़ाइल > पैकेज > नए पैकेज वर्शन पर अपडेट करें" पर जाएं.
3. इंस्टॉल किए जाने की पुष्टि के लिए, Project Navigator के पैकेज डिपेंडेंसी सेक्शन पर जाएं और पैकेज और उसके वर्शन की पुष्टि करें.

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

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

1. अपना Xcode फ़ाइल फ़ोल्डर बंद करें. टर्मिनल खोलें और नीचे दिया गया निर्देश चलाएं:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. अगर Podfile, Podfile.resolved, और Xcode workspace का इस्तेमाल CocoaPods के अलावा किसी और चीज़ के लिए नहीं किया जा रहा है, तो उन्हें हटा दें.

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

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

कोकोपॉड

1. टर्मिनल खोलें और Podfile वाली डायरेक्ट्री पर जाएं:

   cd <path-to-project>

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

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

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

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