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

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

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

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

• नेविगेशन 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 ग्रुप का सदस्य होना चाहिए.

ड्राइवर का 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 इंस्टॉल करने का निर्देश चलाएं: यह निर्देश, Podfile में बताए गए एपीआई और उनकी डिपेंडेंसी को इंस्टॉल करेगा.

   pod install
   

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

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

Swift Package Manager

ड्राइवर SDK टूल को Swift पैकेज मैनेजर की मदद से इंस्टॉल किया जा सकता है. 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 में अपनी बिल्ड सेटिंग कॉन्फ़िगर करने का तरीका बताया गया है.

चेतावनी: सबसे सही तरीका यह है कि जब भी मुमकिन हो, Cocoapods का इस्तेमाल करके ड्राइवर SDK टूल इंस्टॉल करें.

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

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

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

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

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

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