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

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

अपने iOS उपभोक्ता ऐप्लिकेशन में ऑन-डिमांड यात्राओं को फ़ॉलो करने के लिए, Consumer SDK का इस्तेमाल करें. यात्राओं को फ़ॉलो करने के बारे में ज़्यादा जानने के लिए, 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 दबाएं और "Add Package" पर क्लिक करें.
  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. इंस्टॉलेशन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. इससे पैकेज और उसके वर्शन की पुष्टि की जा सकेगी.

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

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

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

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

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

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

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

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

  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 जोड़ें.

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

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

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

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

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

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