इस सेक्शन में बताया गया है कि यह कैसे पुष्टि की जाए कि आपका सिस्टम, ज़रूरी शर्तों को पूरा करता है. साथ ही, इसमें Workspace ग्रुप सेट अप करने और ड्राइवर एसडीके पाने का तरीका भी बताया गया है.
शुरू करने से पहले
iOS के लिए Driver SDK का इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को ये ज़रूरी शर्तें पूरी करनी होंगी:
- Navigation SDK टूल का इस्तेमाल किया जा रहा हो.
- अपने Google Cloud कंसोल में, iOS के लिए Maps SDK को चालू करें और एपीआई पासकोड पाएं.
सिस्टम की ज़रूरी शर्तें देखना
ड्राइवर SDK टूल के जिस वर्शन का इस्तेमाल किया जा रहा है उसके लिए ज़रूरी शर्तों को जानने के लिए, रिलीज़ नोट देखें. प्रॉडक्ट की जानकारी देखें.
- मोबाइल डिवाइस, iOS 16 या इसके बाद के वर्शन पर काम करता हो.
- Apple Xcode वर्शन 26 या इसके बाद का वर्शन.
अपने Google Workspace का ऐक्सेस पाना
अगर आप Google Workspace के ग्राहक हैं, तो यह तरीका अपनाएं:
Workspace ग्रुप बनाएं. ज़्यादा जानकारी के लिए, Workspace ग्रुप देखें.
उदाहरण के लिए, सबसे सही तरीके के तौर पर, शामिल होने के दौरान अपने ग्रुप का नाम
google-maps-platform-sdk-users@workspacedomain.comरखें.Google को अपने Workspace ग्रुप का नाम दें, ताकि वह उसे अनुमति वाली सूची में जोड़ सके. इससे आपको CocoaPods की सही रिपॉज़िटरी का ऐक्सेस मिलेगा.
पुष्टि करें कि जिन उपयोगकर्ताओं और सेवा खातों को ऐक्सेस देना है उनके ईमेल पते इस सूची में शामिल हों.
अगर आपके संगठन के पास 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
CocoaPods टूल इंस्टॉल करें: टर्मिनल विंडो खोलें और यह कमांड चलाएं.
sudo gem install cocoapodsज़्यादा जानकारी के लिए, CocoaPods का इस्तेमाल शुरू करने से जुड़ी गाइड देखें.
Driver SDK के लिए Podfile बनाएं: Podfile का इस्तेमाल, एपीआई और उसकी डिपेंडेंसी इंस्टॉल करने के लिए किया जाता है.
अपनी प्रोजेक्ट डायरेक्ट्री में
Podfileनाम की फ़ाइल बनाएं. इस फ़ाइल से आपके प्रोजेक्ट की डिपेंडेंसी तय होती हैं.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' endPodfile सेव करें: टर्मिनल खोलें और Podfile वाले फ़ोल्डर पर जाएं:
cd <path-to-project>
pod install कमांड चलाएं: यह कमांड, Podfile में बताए गए एपीआई के साथ-साथ, उनकी सभी डिपेंडेंसी को इंस्टॉल कर देगा.
pod installXcode में अपना प्रोजेक्ट खोलें: Xcode को बंद करें. इसके बाद, Xcode को लॉन्च करने के लिए, अपने प्रोजेक्ट की .xcworkspace फ़ाइल को खोलें (दो बार क्लिक करें). प्रोजेक्ट को बाद में खोलने के लिए, .xcworkspace फ़ाइल का इस्तेमाल करें.
Swift Package Manager
ड्राइवर एसडीके को Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. एसडीके जोड़ने के लिए, पक्का करें कि आपने ड्राइवर एसडीके की सभी मौजूदा डिपेंडेंसी हटा दी हों.
किसी नए या मौजूदा प्रोजेक्ट में SDK टूल जोड़ने के लिए, यह तरीका अपनाएं:
-
Xcode
projectयाworkspaceखोलें. इसके बाद, File > Add Package Dependencies पर जाएं. - यूआरएल के तौर पर https://github.com/googlemaps/ios-driver-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "Add Package" पर क्लिक करें.
-
कोई खास
versionइंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन के हिसाब से उपलब्ध विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप नया वर्शन तय करें और "Exact Version" विकल्प का इस्तेमाल करें. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें. -
पैकेज प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि
GoogleRidesharingDriverको आपके तय किए गएmainटारगेट में जोड़ा जाएगा. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें. - इंस्टॉलेशन की पुष्टि करने के लिए, अपने टारगेट के सामान्य पैनल पर जाएं. Frameworks, Libraries, and Embedded Content में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, "प्रोजेक्ट नेविगेटर" के "पैकेज डिपेंडेंसी" सेक्शन को भी देखा जा सकता है.
किसी मौजूदा प्रोजेक्ट के लिए package को अपडेट करने के लिए, यह तरीका अपनाएं:
- Xcode में, File > Packages > Update To Latest Package Versions पर जाएं.
- इंस्टॉलेशन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. इससे पैकेज और उसके वर्शन की पुष्टि की जा सकेगी.
मैन्युअल तरीके से इंस्टॉल किए गए मौजूदा Driver SDK को हटाने के लिए, यह तरीका अपनाएं:
Xcode प्रोजेक्ट के कॉन्फ़िगरेशन की सेटिंग में जाकर, Frameworks, Libraries, and Embedded Content ढूंढें. इस फ़्रेमवर्क को हटाने के लिए, माइनस के निशान
(-)का इस्तेमाल करें:GoogleRidesharingDriver.xcframework
अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री से,
GoogleRidesharingDriverबंडल को हटाएं.
मैन्युअल तरीके से इंस्टॉल करना
इस गाइड में, Driver SDK वाले XCFramework को अपने प्रोजेक्ट में मैन्युअल तरीके से जोड़ने और Xcode में बिल्ड सेटिंग कॉन्फ़िगर करने का तरीका बताया गया है.
इस गाइड में दिए गए निर्देशों का पालन करने से पहले, ये काम करें:
XCFramework डाउनलोड करें. यह एक बाइनरी पैकेज है, जिसका इस्तेमाल ड्राइवर SDK टूल को इंस्टॉल करने के लिए किया जाता है. इस पैकेज का इस्तेमाल कई प्लैटफ़ॉर्म पर किया जा सकता है. इनमें Apple सिलिकॉन का इस्तेमाल करने वाली मशीनें भी शामिल हैं
Navigation SDK इंस्टॉल करें.
ड्राइवर SDK टूल को मैन्युअल तरीके से इंस्टॉल करने के लिए, यह तरीका अपनाएं:
एसडीके बाइनरी और संसाधन डाउनलोड करें:
XCFramework और संसाधनों को ऐक्सेस करने के लिए, ZIP फ़ाइलों को अनपैक करें.
Xcode खोलें और कोई मौजूदा प्रोजेक्ट खोलें या नया प्रोजेक्ट बनाएं. अगर आप iOS के लिए पहली बार ऐप्लिकेशन बना रहे हैं, तो एक नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.
अगर आपके प्रोजेक्ट ग्रुप में फ़्रेमवर्क ग्रुप नहीं है, तो उसे बनाएं.
ड्राइवर SDK टूल इंस्टॉल करने के लिए,
GoogleRidesharingDriver.xcframeworkफ़ाइल को फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किए गए कॉन्टेंट में जाकर, अपने प्रोजेक्ट में खींचें और छोड़ें. अगर कहा जाए, तो आइटम कॉपी करें को चुनें.डाउनलोड की गई
GoogleRidesharingDriver.bundleको अपने Xcode प्रोजेक्ट की टॉप-लेवल डायरेक्ट्री में खींचें और छोड़ें. अगर कहा जाए, तो आइटम कॉपी करें को चुनें.प्रोजेक्ट नेविगेटर में जाकर अपना प्रोजेक्ट चुनें. इसके बाद, अपने ऐप्लिकेशन का टारगेट चुनें.
Build Phases टैब खोलें. इसके बाद, Link Binary with Libraries में जाकर, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें. ऐसा तब करें, जब ये पहले से मौजूद न हों:
Accelerate.frameworkAudioToolbox.frameworkAVFoundation.frameworkCoreData.frameworkCoreGraphics.frameworkCoreLocation.frameworkCoreTelephony.frameworkCoreText.frameworkGLKit.frameworkImageIO.frameworklibc++.tbdlibxml2.tbdlibz.tbdLocalAuthentication.frameworkOpenGLES.frameworkQuartzCore.frameworkSystemConfiguration.frameworkUIKit.frameworkWebKit.framework
किसी खास टारगेट के बजाय अपना प्रोजेक्ट चुनें और Build Settings टैब खोलें. Other Linker Flags सेक्शन में, डीबग और रिलीज़, दोनों के लिए
-ObjCजोड़ें.अगर ये सेटिंग नहीं दिख रही हैं, तो Build Settings बार में मौजूद फ़िल्टर को Basic से बदलकर All पर सेट करें.
Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना
Apple के मुताबिक, App Store पर मौजूद ऐप्लिकेशन के लिए, ऐप्लिकेशन की निजता से जुड़ी जानकारी देना ज़रूरी है. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store पर निजता की जानकारी वाले पेज पर जाएं.
Apple की प्राइवसी मेनिफ़ेस्ट फ़ाइल, SDK टूल के संसाधनों के बंडल में शामिल होती है. यह पुष्टि करने के लिए कि प्राइवसी मेनिफ़ेस्ट फ़ाइल को शामिल किया गया है और उसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं. इसके बाद, संग्रह से निजता रिपोर्ट जनरेट करें.
आगे क्या करना है
Google Cloud Console प्रोजेक्ट को कॉन्फ़िगर करना