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 टूल को शुरू करें.

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

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

• मोबाइल डिवाइस, iOS 16 या इसके बाद के वर्शन पर काम करता हो.
• Apple Xcode वर्शन 26 या इसके बाद का वर्शन.

Consumer SDK टूल डाउनलोड करना

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

Swift Package Manager

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

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

1. Xcode project या workspace खोलें. इसके बाद, File > Add Package Dependencies पर जाएं.
2. यूआरएल के तौर पर https://github.com/googlemaps/ios-consumer-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
3. कोई खास version इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन पर आधारित किसी विकल्प पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप नए वर्शन की जानकारी दें और "Exact Version" विकल्प का इस्तेमाल करें. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें.
4. पैकेज के प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि GoogleRidesharingConsumer को आपके तय किए गए main टारगेट में जोड़ा जाएगा. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें.
5. इंस्टॉलेशन की पुष्टि करने के लिए, अपने टारगेट के General पैनल पर जाएं. Frameworks, Libraries, and Embedded Content में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, "Project Navigator" के "Package Dependencies" सेक्शन को भी देखा जा सकता है.

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

1. Xcode में, File > Packages > Update To Latest Package Versions पर जाएं.
2. इंस्टॉलेशन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. इससे पैकेज और उसके वर्शन की पुष्टि की जा सकेगी.

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

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

1. Xcode प्रोजेक्ट की कॉन्फ़िगरेशन सेटिंग में जाकर, Frameworks, Libraries, and Embedded Content ढूंढें. इस फ़्रेमवर्क को हटाने के लिए, माइनस के निशान(-) का इस्तेमाल करें:

   • 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 को चलाएं, ताकि पता चल सके कि SDK टूल का नया वर्शन कब उपलब्ध है. ज़्यादा जानकारी के लिए, Consumer SDK के रिलीज़ नोट में Consumer SDK के वर्शन देखें.

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

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

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

इस गाइड में दिए गए निर्देशों का पालन करने से पहले, ये काम करें:

• XCFramework डाउनलोड करें. यह एक बाइनरी पैकेज है, जिसका इस्तेमाल उपभोक्ता 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. Build Phases टैब खोलें. इसके बाद, Link Binary with Libraries में, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें. ऐसा तब करें, जब वे पहले से मौजूद न हों:

   • 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. किसी खास टारगेट के बजाय अपना प्रोजेक्ट चुनें और Build Settings टैब खोलें. Other Linker Flags सेक्शन में, डीबग और रिलीज़, दोनों के लिए -ObjC जोड़ें.

    अगर ये सेटिंग नहीं दिख रही हैं, तो Build Settings बार में जाकर, फ़िल्टर को Basic से All पर सेट करें.

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

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

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

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

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