iOS वर्शन के लिए Maps SDK टूल

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

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

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

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

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

  फ़ायदे:

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

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

  फ़ायदे:

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

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

इंस्टॉल करना

Swift पैकेज मैनेजर

iOS के लिए Maps SDK को Swift पैकेज मैनेजर. SDK टूल जोड़ने के लिए, पक्का करें कि iOS डिपेंडेंसी के लिए सभी मौजूदा Maps SDK टूल हटा दिए गए हैं.

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

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

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

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

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

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

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

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

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

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

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

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

CocoaPods

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

इसका इस्तेमाल करके, Podfile डिपेंडेंसी का एक उदाहरण Podfile सिंटैक्स:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '8.4.0'
end

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

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

Swift पैकेज मैनेजर

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

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

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

Cocoapods

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

   cd <path-to-project>

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

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

नए सोर्स फ़ाइलों का लिंक पाना पर क्लिक करें.

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