iOS कंज़्यूमर SDK टूल डाउनलोड करें

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

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

उदाहरण के लिए, iOS के सैंपल ऐप्लिकेशन देखें या मिले-जुले सैंपल.

अगर आपको अपने iOS उपभोक्ता ऐप्लिकेशन के लिए उपभोक्ता SDK टूल सेट अप करना है, तो यह तरीका अपनाएं:

1. सिस्टम से जुड़ी ज़रूरी शर्तें देखें.
2. उपभोक्ता SDK टूल पाएं.
3. Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करें.
4. Google Cloud Console प्रोजेक्ट को कॉन्फ़िगर करना.
5. पुष्टि करने वाले टोकन पाएं.
6. उपभोक्ता SDK टूल शुरू करें.

सिस्टम से जुड़ी ज़रूरी शर्तें देखें

ऐप्लिकेशन के वर्शन की ज़रूरी शर्तों के बारे में जानने के लिए, रिलीज़ नोट देखें आपके इस्तेमाल किए जा रहे उपभोक्ता SDK टूल. प्रॉडक्ट की जानकारी देखें.

• मोबाइल डिवाइस में iOS 14 या उसके बाद का वर्शन होना चाहिए.
• Apple Xcode वर्शन 15 या इसके बाद के वर्शन.

उपभोक्ता SDK टूल डाउनलोड करें

CocoaPods के साथ उपभोक्ता SDK टूल को इंस्टॉल और कॉन्फ़िगर करें.

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

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

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

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

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

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

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

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

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

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

इंस्टॉल किए गए मौजूदा उपभोक्ता SDK टूल को हटाने के लिए तो मैन्युअल रूप से, इन चरणों का पालन करें:

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

   • GoogleRidesharingConsumer.xcframework

2. अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री से, GoogleRidesharingConsumer बंडल.

CocoaPods का इस्तेमाल करें

1. CocoaPods टूल इंस्टॉल करें: टर्मिनल विंडो खोलें और निम्न कमांड चलाएं:

   sudo gem install cocoapods
   

   ज़्यादा जानकारी के लिए, इसे देखें CocoaPods का इस्तेमाल शुरू करने के बारे में गाइड.

2. उपभोक्ता SDK टूल के लिए Podfile बनाएं: API और उसकी डिपेंडेंसी को इंस्टॉल करने के लिए, Podfile का इस्तेमाल करें.

   1. अपनी प्रोजेक्ट डायरेक्ट्री में Podfile नाम की फ़ाइल बनाएं. यह फ़ाइल आपके प्रोजेक्ट की डिपेंडेंसी के बारे में बताता है.

   2. Podfile में बदलाव करें और अपनी डिपेंडेंसी जोड़ें. यहां है एक उदाहरण, जिसमें डिपेंडेंसी शामिल हैं:

      source "https://github.com/CocoaPods/Specs.git"
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingConsumer'
      end
      

   3. Podfile सेव करें: कोई टर्मिनल खोलें और पॉडफ़ाइल:

      cd <path-to-project>
      

3. pod इंस्टॉल करने का निर्देश चलाएं: यह निर्देश एपीआई इंस्टॉल करता है के साथ-साथ उनकी निर्भरता के साथ भी उन्हें शामिल कर सकते हैं.

   pod install
   

4. अपने प्रोजेक्ट को Xcode में खोलें: Xcode को बंद करें और फिर खोलें (डबल क्लिक करें) आपके प्रोजेक्ट की .xcworkspace फ़ाइल होगी. प्रोजेक्ट खोलने के लिए बाद में, .xcworkspace फ़ाइल का इस्तेमाल करें.

   ध्यान दें: समय-समय पर pod outdated चलाएं, ताकि पता लगाया जा सके कि कब SDK का नया वर्शन मौजूद है. ज़्यादा जानकारी के लिए, यह देखें उपभोक्ता SDK टूल की जानकारी में, उपभोक्ता के SDK टूल के वर्शन.

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

इस गाइड में XCFramework को मैन्युअल तरीके से जोड़ने का तरीका बताया गया है. उपभोक्ता SDK टूल को अपने प्रोजेक्ट में जोड़ें और Xcode में अपनी बिल्ड सेटिंग कॉन्फ़िगर करें.

चेतावनी: सबसे सही तरीका यह है कि Cocoapods जब भी ग्राहक SDK टूल को इंस्टॉल करे, ऐसा हो सकता है.

इस गाइड का इस्तेमाल करने से पहले, ये काम करें:

• XCFramework डाउनलोड करें, एक बाइनरी पैकेज जिसका उपयोग आप उपभोक्ता SDK टूल. इस पैकेज का इस्तेमाल कई प्लैटफ़ॉर्म पर किया जा सकता है. इनमें ये प्लैटफ़ॉर्म भी शामिल हैं M1 चिपसेट का इस्तेमाल करने वाली मशीनें हैं.

• इंस्टॉल करें Maps SDK टूल.

1. SDK टूल बाइनरी और संसाधन डाउनलोड करें:

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

2. XCFramework और संसाधनों को ऐक्सेस करने के लिए, ज़िप की गई फ़ाइलों को अनपैक करें.

3. Xcode शुरू करें और कोई प्रोजेक्ट खोलें या नया प्रोजेक्ट बनाएं. अगर आपने iOS का इस्तेमाल पहले नहीं किया है, तो नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.

4. अगर आपके प्रोजेक्ट ग्रुप में फ़्रेमवर्क ग्रुप नहीं है, तो उसे बनाएं.

5. डाउनलोड की गई gRPCCertificates.bundle फ़ाइल को खींचकर टॉप-लेवल पर छोड़ें डायरेक्ट्री में जोड़ा जा सकता है. अगर कहा जाए, तो आइटम कॉपी करें चुनें.

6. उपभोक्ता SDK टूल इंस्टॉल करने के लिए, GoogleRidesharingConsumer.xcframework फ़ाइल को फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट. अगर कहा जाए, तो आइटम कॉपी करना.

7. डाउनलोड किए गए GoogleRidesharingConsumer.bundle को खींचकर, आपके Xcode प्रोजेक्ट की टॉप-लेवल की डायरेक्ट्री. अगर कहा जाए, तो आइटम कॉपी करना.

8. Project Navigator से प्रोजेक्ट चुनें और का लक्ष्य तय करना.

9. चरण बनाएं टैब खोलें और बाइनरी को लाइब्रेरी से लिंक करें में, अगर ये फ़्रेमवर्क और लाइब्रेरी पहले से नहीं हैं, तो उन्हें जोड़ें उपस्थित:

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें और बिल्ड सेटिंग टैब. अन्य लिंकर फ़्लैग सेक्शन में, डीबग और रिलीज़, दोनों के लिए -ObjC जोड़ें.

    अगर ये सेटिंग नहीं दिखती हैं, तो इस विकल्प का इस्तेमाल करके फ़िल्टर बदलें बिल्ड सेटिंग बार को बेसिक से सभी पर सेट करें.

Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करें

Apple को App Store पर मौजूद ऐप्लिकेशन के लिए, ऐप्लिकेशन की निजता से जुड़ी जानकारी की ज़रूरत होती है. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store के निजता से जुड़ी जानकारी वाले पेज पर जाएं.

Apple Privacy मेनिफ़ेस्ट फ़ाइल, SDK टूल के लिए संसाधनों के बंडल में शामिल होती है. यह पुष्टि करने के लिए कि निजता मेनिफ़ेस्ट फ़ाइल शामिल की गई है और इसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं और संग्रह से निजता रिपोर्ट जनरेट करें.

आगे क्या करना है

Google Cloud Console प्रोजेक्ट को कॉन्फ़िगर करना