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

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

अपने iOS उपभोक्ता ऐप्लिकेशन में मांग पर यात्राओं को फ़ॉलो करने के लिए, उपभोक्ता 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 या इसके बाद का वर्शन.

उपभोक्ता 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 के पैकेज डिपेंडेंसी सेक्शन पर जाएं और पैकेज और उसके वर्शन की पुष्टि करें.

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

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

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

   • GoogleRidesharingConsumer.xcframework

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

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

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

   sudo gem install cocoapods
   

   ज़्यादा जानकारी के लिए, CocoaPods के लिए शुरुआती निर्देश देखें.

2. उपभोक्ता 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 टूल के वर्शन देखें.

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

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

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

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

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

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

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