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

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

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

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

  • आपके पास Navigation SDK होना चाहिए.
  • Google Cloud Console में जाकर, Maps SDK for iOS को चालू करें और एपीआई पासकोड पाएं.

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

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

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

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

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

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

    उदाहरण के लिए, सबसे सही तरीके के तौर पर, ग्रुप को [email protected] नाम दें.

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

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

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

Cloud SDK की मदद से साइन इन करना

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

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

gcloud

gcloud auth login

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

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

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

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

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

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

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 के लिए Alpha और Beta पॉड को डिपेंडेंसी के तौर पर शामिल किया गया है:

      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 की मदद से इंस्टॉल किया जा सकता है. SDK टूल जोड़ने के लिए, पक्का करें कि आपने Driver SDK की सभी मौजूदा डिपेंडेंसी हटा दी हों.

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

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

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

  1. इंस्टॉल करने की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. यहां पैकेज और उसके वर्शन की पुष्टि करें.

मैन्युअल तरीके से इंस्टॉल किए गए मौजूदा 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. SDK टूल की बाइनरी और संसाधन डाउनलोड करें:

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

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

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

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

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

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

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

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

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

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

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

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