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 16 या उसके बाद का वर्शन होना चाहिए.
• Apple Xcode का वर्शन 26 या उसके बाद का वर्शन होना चाहिए.

Consumer SDK पाना

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

Swift Package Manager

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

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

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

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

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

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

मैन्युअल तरीके से इंस्टॉल किए गए मौजूदा 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 फ़ाइल का इस्तेमाल करें.

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

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

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

चेतावनी: हमारा सुझाव है कि Consumer SDK इंस्टॉल करने के लिए, जहां तक हो सके Cocoapods का इस्तेमाल करें.

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

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

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

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

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

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

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