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

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

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

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

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

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

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

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

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

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

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

   उदाहरण के लिए, सबसे सही तरीके के तौर पर, शामिल होने के दौरान अपने ग्रुप का नाम [e-mail] रखें.

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

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

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

ध्यान दें: Workspace ग्रुप, Google Groups से अलग होते हैं. Google Groups के आखिर में @googlegroups.com आता है. सिर्फ़ Workspace ग्रुप का इस्तेमाल किया जा सकता है.

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 फ़ाइल का इस्तेमाल करें.

   ध्यान दें: SDK टूल का नया वर्शन उपलब्ध होने पर, इसकी जानकारी पाने के लिए समय-समय पर pod outdated को चलाएं. ज़्यादा जानकारी के लिए, iOS वर्शन के लिए ड्राइवर SDK टूल देखें.

Swift Package Manager

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

अहम जानकारी: ये निर्देश, Xcode 15 या इसके बाद के वर्शन के लिए हैं. हालांकि, ये Xcode के पिछले वर्शन के लिए भी काम के हो सकते हैं.

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

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

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework

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

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

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

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

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

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

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

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

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 की प्राइवसी मेनिफ़ेस्ट फ़ाइल, SDK टूल के संसाधन बंडल में शामिल होती है. निजता मेनिफ़ेस्ट फ़ाइल को शामिल किए जाने की पुष्टि करने और उसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं और संग्रह से निजता रिपोर्ट जनरेट करें.

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

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