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

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

अपने iOS उपभोक्ता ऐप्लिकेशन में, ऑन-डिमांड राइड की सुविधा का इस्तेमाल करने के लिए, Consumer SDK का इस्तेमाल करें. यात्राओं को फ़ॉलो करने के बारे में ज़्यादा जानने और इस सुविधा के बारे में जानकारी पाने के लिए, iOS पर किसी यात्रा को फ़ॉलो करना लेख पढ़ें.

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

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

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

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

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

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

Consumer SDK टूल पाना

CocoaPods की मदद से, Consumer SDK टूल को इंस्टॉल और कॉन्फ़िगर किया जाता है.

Swift Package Manager

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

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

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

1. Xcode project या workspace खोलें. इसके बाद, फ़ाइल > पैकेज की डिपेंडेंसी जोड़ें पर जाएं.
2. यूआरएल के तौर पर https://github.com/googlemaps/ios-consumer-sdk डालें. इसके बाद, पैकेज को इंपोर्ट करने के लिए Enter दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
3. किसी खास version को इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन पर आधारित विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप "सटीक वर्शन" विकल्प का इस्तेमाल करके, सबसे नया वर्शन डालें. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें.

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

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

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

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

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

   • GoogleRidesharingConsumer.xcframework

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

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

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

   sudo gem install cocoapods
   

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

2. Consumer SDK टूल के लिए Podfile बनाएं: एपीआई और उसकी डिपेंडेंसी को इंस्टॉल करने के लिए, Podfile का इस्तेमाल किया जाता है.

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

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

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

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

      cd <path-to-project>
      

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

   pod install
   

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

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

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

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

चेतावनी: सबसे सही तरीके के तौर पर, जब भी हो सके, Consumer SDK टूल को इंस्टॉल करने के लिए Cocoapods का इस्तेमाल करें.

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

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

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

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

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

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

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

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

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

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

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

8. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें और अपने ऐप्लिकेशन का टारगेट चुनें.

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 की प्राइवसी मेनिफ़ेस्ट फ़ाइल, SDK टूल के संसाधन बंडल में शामिल होती है. निजता मेनिफ़ेस्ट फ़ाइल को शामिल किए जाने की पुष्टि करने और उसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं और संग्रह से निजता रिपोर्ट जनरेट करें.

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

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