ड्राइवर SDK टूल पाएं

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

शुरू करने से पहले

iOS के लिए ड्राइवर SDK टूल का इस्तेमाल करने के लिए ज़रूरी है कि आपका ऐप्लिकेशन नीचे दी गई शर्तें पूरी करे:

  • नेविगेशन SDK टूल रखें.
  • अपने Google Cloud Console में iOS के लिए Maps SDK टूल को चालू करें और एपीआई पासकोड पाएं.

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

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

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

अपने Google Workspace का ऐक्सेस पाएं

अगर आप Google Workspace के ग्राहक हैं, तो यह तरीका अपनाएं:

  1. Workspace ग्रुप बनाएं. ज़्यादा जानकारी के लिए, Workspace ग्रुप देखें.

    उदाहरण के लिए, सबसे सही तरीका यह है कि अपने ग्रुप को नाम दें ऑनबोर्डिंग के दौरान google-maps-platform-sdk-users@workspacedomain.com.

  2. Google को उसका नाम दें, ताकि आप अपने Workspace ग्रुप को, अनुमति वाले डोमेन की सूची में जोड़ सकें CocoaPods का डेटा स्टोर करने की सही जगह का ऐक्सेस देता है.

  3. पुष्टि करें कि उपयोगकर्ता के जिन ईमेल और सेवा खाते के ईमेल को ऐक्सेस करने की ज़रूरत है जो इस सूची में शामिल हैं.

अगर आपका संगठन, Workspace ग्रुप नहीं बना सकता, तो Google को सूची भेजें उन उपयोगकर्ता और सेवा खाते के ईमेल पते हैं जिन्हें इन आर्टफ़ैक्ट का ऐक्सेस चाहिए.

Cloud SDK टूल से साइन इन करें

लोकल डेवलपमेंट के लिए, Cloud SDK टूल से साइन इन करें. ज़्यादा जानकारी के लिए, gcloud सीएलआई इंस्टॉल करें देखें.

नीचे दिए गए उदाहरणों में, Cloud SDK से साइन इन करने का तरीका बताया गया है.

gcloud

gcloud auth login

आपको वह ईमेल पता इस्तेमाल करना होगा जो Workspace ग्रुप में शामिल है.

ऑटोमेशन होस्ट सेट अप करना

बिल्ड सिस्टम या लगातार इंटिग्रेशन के लिए, अपने ऑटोमेशन होस्ट के आधार पर सेट अप करें को प्रमाणित करने के लिए सेवा खाते का इस्तेमाल करने के तरीकों की दी गई सूची में Google API और सेवाएं. ज़्यादा जानकारी के लिए, सेवा खाता सेक्शन देखें पर जाएं.

  • अगर आपकी प्रोसेस Google Cloud के एनवायरमेंट में चलती है, तो इसका इस्तेमाल करें क्रेडेंशियल की अपने-आप पहचान करने की सुविधा. ज़्यादा जानकारी के लिए, अपने-आप क्रेडेंशियल की पहचान होने की सुविधा देखें.

  • अगर ऐसा नहीं है, तो सेवा खाते की कुंजी वाली फ़ाइल को होस्ट का फ़ाइल-सिस्टम और GOOGLE_APPLICATION_CREDENTIALS को सेट करें एनवायरमेंट वैरिएबल में सही तरीके से बदलाव किया हो. ज़्यादा जानकारी के लिए, GOOGLE_APPLICATION_CREDENTIALS देखें.

क्रेडेंशियल से जुड़े सेवा खाते का ईमेल पता, शामिल हैं.

ड्राइवर का SDK टूल डाउनलोड करें

ड्राइवर SDK टूल इंस्टॉल और कॉन्फ़िगर करें.

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 'GoogleRidesharingDriver'
      end
      

      यहां एक उदाहरण दिया गया है, जिसमें डिपेंडेंसी के तौर पर ड्राइवर SDK टूल:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      
    3. Podfile सेव करें: कोई टर्मिनल खोलें और पॉडफ़ाइल:

      cd <path-to-project>
      
  3. pod इंस्टॉल करने का निर्देश चलाएं: इस निर्देश से एपीआई इंस्टॉल हो जाएंगे के साथ-साथ उनकी निर्भरता के साथ भी उन्हें शामिल कर सकते हैं.

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

Swift पैकेज मैनेजर

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

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

  1. अपना Xcode project या workspace खोलें. इसके बाद, फ़ाइल > पैकेज डिपेंडेंसी जोड़ें.
  2. यूआरएल के तौर पर https://github.com/googlemaps/ios-driver-sdk डालें और Enter दबाएं पैकेज खोलने के लिए, और "पैकेज जोड़ें" पर क्लिक करें.
  3. किसी खास version को इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को इनमें से किसी एक पर सेट करें विकल्प चुने जा सकते हैं. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप सबसे नया वर्शन और सटीक वर्शन का इस्तेमाल करके का विकल्प शामिल है. यह प्रोसेस पूरी होने के बाद, "Add Package" पर क्लिक करें.
  4. पैकेज प्रॉडक्ट चुनें विंडो से, पुष्टि करें कि GoogleRidesharingDriver को पैकेज प्रॉडक्ट में जोड़ा जाएगा आपका तय किया गया main टारगेट. यह प्रोसेस पूरी होने के बाद, "Add Package" पर क्लिक करें.
  5. अपने इंस्टॉलेशन की पुष्टि करने के लिए, टारगेट के General पैनल पर जाएं. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किए गए कॉन्टेंट में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. "पैकेज डिपेंडेंसी" भी देखी जा सकती है "प्रोजेक्ट नेविगेटर" का सेक्शन की पुष्टि करें.

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

  1. अगर आप 9.0.0 से पहले के वर्शन से अपग्रेड कर रहे हैं, तो आपको ये डिपेंडेंसी: GoogleMapsBase, GoogleMapsCore, और अपग्रेड करने के बाद, GoogleMapsM4B देने होंगे. इसके लिए डिपेंडेंसी न हटाएं GoogleMaps. ज़्यादा जानकारी के लिए, देखें वर्शन 9.0.0 के बारे में जानकारी.

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

    • GoogleMapsBase (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
    • GoogleMapsCore (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
    • GoogleMapsM4B (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
  2. Xcode से, "फ़ाइल > पैकेज > सबसे नए पैकेज वर्शन पर अपडेट करें".
  3. इंस्टॉल किए जाने की पुष्टि के लिए, Project Navigator के पैकेज डिपेंडेंसी सेक्शन पर जाएं की पुष्टि करें.

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

  1. अपना Xcode फ़ाइल फ़ोल्डर बंद करें. टर्मिनल खोलें और नीचे दिया गया निर्देश चलाएं:
    sudo gem install cocoapods-deintegrate cocoapods-clean 
    pod deintegrate 
    pod cache clean --all
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  2. Podfile, Podfile.resolved, और अगर CocoaPods के अलावा, किसी और चीज़ के लिए उनका इस्तेमाल नहीं किया जा रहा है, तो Xcode workspace.

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

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

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

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

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

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

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

  • नेविगेशन SDK टूल इंस्टॉल करें.

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

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

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

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

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

  5. ड्राइवर SDK टूल इंस्टॉल करने के लिए, GoogleRidesharingDriver.xcframework फ़ाइल को फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट. अगर कहा जाए, तो आइटम कॉपी करना.

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

  7. Project Navigator से प्रोजेक्ट चुनें और का लक्ष्य तय करना.

  8. चरण बनाएं टैब खोलें और बाइनरी को लाइब्रेरी से लिंक करें में, नीचे दिए गए फ़्रेमवर्क और लाइब्रेरी का इस्तेमाल करें, अगर वे पहले से मौजूद नहीं हैं:

    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • LocalAuthentication.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • WebKit.framework
  9. किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें और बिल्ड खोलें सेटिंग टैब पर क्लिक करें. अन्य लिंकर फ़्लैग सेक्शन में, इसके लिए -ObjC जोड़ें डीबग और रिलीज़, दोनों के लिए.

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

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

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

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

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

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