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

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

ध्यान दें: आपके ऐप्लिकेशन में उपलब्ध Places SDK for iOS की सुविधाएं, इन बातों पर निर्भर करती हैं: ऐप्लिकेशन के कॉन्फ़िगरेशन में बताया गया SDK टूल का वर्शन नंबर और आपके एपीआई पासकोड पर चालू किए गए एपीआई. ज़्यादा जानकारी के लिए, एसडीके टूल का वर्शन चुनना लेख पढ़ें.

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

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

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

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

  फ़ायदे:

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

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

  फ़ायदे:

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

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

इंस्टॉल करना

Swift Package Manager

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

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

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

1. Xcode project या workspace खोलें. इसके बाद, File > Add Package Dependencies पर जाएं.
2. यूआरएल के तौर पर https://github.com/googlemaps/ios-places-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
3. किसी खास version को इंस्टॉल करने के लिए, Dependency Rule फ़ील्ड को वर्शन के आधार पर उपलब्ध विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप "Exact Version" विकल्प का इस्तेमाल करके, नए वर्शन के बारे में बताएं. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.
4. पैकेज में शामिल प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि GooglePlaces, GooglePlacesSwift या दोनों को आपके चुने गए मुख्य टारगेट में जोड़ा जाएगा. यह चरण पूरा होने के बाद, पैकेज जोड़ें पर क्लिक करें.

   अगर आपको Google Places Swift को बंद किए गए GitHub यूआरएल से अपडेट करना है

   अहम जानकारी: Google Places Swift को ऐक्सेस करने के लिए, GitHub का यूआरएल बदल गया है. यह बदलाव, वर्शन 0.3.0 से लागू हुआ है. अगर आपको GooglePlacesSwift के ऐसे वर्शन को अपडेट करना है जिसे पुराने यूआरएल https://github.com/googlemaps/ios-places-swift-sdk से ऐक्सेस किया गया था, तो उसे Xcode के पैकेज डिपेंडेंसी सेक्शन से हटाएं.

5. इंस्टॉल करने की पुष्टि करने के लिए, अपने टारगेट के सामान्य पैनल पर जाएं. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में, आपको इंस्टॉल किए गए पैकेज दिखने चाहिए. पैकेज और उसके वर्शन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन को भी देखा जा सकता है.

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

1. Xcode में, "File > Packages > Update To Latest Package Versions" पर जाएं.

   अगर आपको Google Places Swift को बंद किए गए GitHub यूआरएल से अपडेट करना है

   अहम जानकारी: Google Places Swift को ऐक्सेस करने के लिए, GitHub का यूआरएल बदल गया है. यह बदलाव, वर्शन 0.3.0 से लागू हुआ है. अगर आपको GooglePlacesSwift के ऐसे वर्शन को अपडेट करना है जिसे पुराने यूआरएल https://github.com/googlemaps/ios-places-swift-sdk से ऐक्सेस किया गया था, तो उसे Xcode के पैकेज डिपेंडेंसी सेक्शन से हटाएं.

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

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

CocoaPods

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

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

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

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.4.0'
  pod 'GooglePlacesSwift', '10.4.0'
end

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

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

Swift Package Manager

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

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

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

Cocoapods

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

   cd <path-to-project>

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

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

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

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