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

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

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

iOS के लिए Driver SDK का इस्तेमाल करने के लिए, ज़रूरी है कि आपका ऐप्लिकेशन इन शर्तों को पूरा करता हो:

  • उसमें Navigation SDK इंटिग्रेट किया गया हो.
  • Google Cloud Console में, iOS के लिए Maps SDK चालू किया गया हो और उसकी एपीआई कुंजी मिली हो.

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

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

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

Google Workspace का ऐक्सेस पाना

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

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

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

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

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

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

Cloud SDK से साइन इन करना

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

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

gcloud

gcloud auth login

आपको ऐसे ईमेल का इस्तेमाल करना होगा जो Workspace Group का सदस्य हो.

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

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

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

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

क्रेडेंशियल से जुड़ा सेवा खाते का ईमेल पता, Workspace Group का सदस्य होना चाहिए.

Driver SDK पाना

Driver SDK इंस्टॉल और कॉन्फ़िगर करें.

CocoaPods

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

    sudo gem install cocoapods
    

    ज़्यादा जानकारी के लिए, CocoaPods का इस्तेमाल शुरू करने की गाइड देखें.

  2. Driver SDK के लिए Podfile बनाना: एपीआई और उसकी डिपेंडेंसी इंस्टॉल करने के लिए, Podfile का इस्तेमाल किया जाता है.

    1. अपने प्रोजेक्ट की डायरेक्ट्री में, Podfile नाम की फ़ाइल बनाएं. इस फ़ाइल में, आपके प्रोजेक्ट की डिपेंडेंसी तय की जाती हैं.

    2. Podfile में बदलाव करें और अपनी डिपेंडेंसी जोड़ें. यहां एक उदाहरण दिया गया है, जिसमें डिपेंडेंसी शामिल हैं:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      यहां एक उदाहरण दिया गया है, जिसमें Driver 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 सेव करना: टर्मिनल खोलें और उस फ़ोल्डर पर जाएं जिसमें Podfile मौजूद है:

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

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

Swift Package Manager

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  5. Driver SDK इंस्टॉल करने के लिए, GoogleRidesharingDriver.xcframework फ़ाइल को अपने प्रोजेक्ट में Frameworks, Libraries, and Embedded Content में खींचें. अगर कहा जाए, तो Copy items को चुनें.

  6. डाउनलोड किए गए GoogleRidesharingDriver.bundle को अपने Xcode प्रोजेक्ट की सबसे ऊपर वाली डायरेक्ट्री में खींचें. अगर कहा जाए, तो Copy items को चुनें.

  7. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें. इसके बाद, अपने ऐप्लिकेशन का टारगेट चुनें.

  8. Build Phases टैब खोलें. इसके बाद, Link Binary with Libraries में, यहां दिए गए फ़्रेमवर्क और लाइब्रेरी जोड़ें. हालांकि, अगर ये पहले से मौजूद हैं, तो इन्हें जोड़ने की ज़रूरत नहीं है:

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

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

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

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

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

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

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