इस सेक्शन में बताया गया है कि यह कैसे पुष्टि करें कि आपका सिस्टम बुनियादी ज़रूरी शर्तों को पूरा करता है. साथ ही, इसमें Workspace ग्रुप सेट अप करने और Driver SDK पाने का तरीका भी बताया गया है.
शुरू करने से पहले
iOS के लिए Driver SDK का इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को ये शर्तें पूरी करनी होंगी:
- Navigation SDK टूल का इस्तेमाल किया जा रहा हो.
- अपने Google Cloud कंसोल में, iOS के लिए Maps SDK को चालू करें और एपीआई पासकोड पाएं.
सिस्टम की ज़रूरी शर्तें देखना
Driver 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 का इस्तेमाल शुरू करने से जुड़ी गाइड देखें.
ड्राइवर SDK के लिए Podfile बनाएं: Podfile का इस्तेमाल करके, एपीआई और उसकी डिपेंडेंसी इंस्टॉल की जाती हैं.
अपनी प्रोजेक्ट डायरेक्ट्री में
Podfileनाम की फ़ाइल बनाएं. इस फ़ाइल में आपके प्रोजेक्ट की डिपेंडेंसी तय की जाती हैं.Podfile में बदलाव करें और अपनी डिपेंडेंसी जोड़ें. यहां एक उदाहरण दिया गया है, जिसमें डिपेंडेंसी शामिल हैं:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' endयहां एक उदाहरण दिया गया है, जिसमें डिपेंडेंसी के तौर पर ड्राइवर एसडीके के लिए, ऐल्फ़ा और बीटा पॉड शामिल हैं:
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
Driver SDK को Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. एसडीके जोड़ने के लिए, पक्का करें कि आपने Driver SDK की सभी मौजूदा डिपेंडेंसी हटा दी हों.
किसी नए या मौजूदा प्रोजेक्ट में SDK टूल जोड़ने के लिए, यह तरीका अपनाएं:
-
Xcode
projectयाworkspaceखोलें. इसके बाद, File > Add Package Dependencies पर जाएं. - यूआरएल के तौर पर https://github.com/googlemaps/ios-driver-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "Add Package" पर क्लिक करें.
-
किसी खास
versionको इंस्टॉल करने के लिए, डिपेंडेंसी का नियम फ़ील्ड को वर्शन के आधार पर उपलब्ध विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप नए वर्शन की जानकारी दें और "Exact Version" विकल्प का इस्तेमाल करें. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें. -
पैकेज में शामिल किए जाने वाले प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि
GoogleRidesharingDriverको आपके चुने गएmainटारगेट में जोड़ा जाएगा. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें. - इंस्टॉलेशन की पुष्टि करने के लिए, टारगेट के सामान्य पैनल पर जाएं. आपको फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, "प्रोजेक्ट नेविगेटर" के "पैकेज डिपेंडेंसी" सेक्शन को भी देखा जा सकता है.
किसी मौजूदा प्रोजेक्ट के लिए 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 डाउनलोड करें. यह एक बाइनरी पैकेज है. इसका इस्तेमाल Driver SDK को इंस्टॉल करने के लिए किया जाता है. इस पैकेज का इस्तेमाल कई प्लैटफ़ॉर्म पर किया जा सकता है. इनमें Apple सिलिकॉन का इस्तेमाल करने वाली मशीनें भी शामिल हैं
Navigation SDK इंस्टॉल करें.
ड्राइवर SDK टूल को मैन्युअल तरीके से इंस्टॉल करने के लिए, यह तरीका अपनाएं:
एसडीके बाइनरी और संसाधन डाउनलोड करें:
XCFramework और संसाधनों को ऐक्सेस करने के लिए, ज़िप की गई फ़ाइलों को अनपैक करें.
Xcode शुरू करें और कोई मौजूदा प्रोजेक्ट खोलें या नया प्रोजेक्ट बनाएं. अगर आपने iOS का इस्तेमाल पहले कभी नहीं किया है, तो एक नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.
अगर आपके प्रोजेक्ट ग्रुप में फ़्रेमवर्क ग्रुप नहीं है, तो उसे बनाएं.
Driver SDK टूल को इंस्टॉल करने के लिए,
GoogleRidesharingDriver.xcframeworkफ़ाइल को Frameworks, Libraries, and Embedded Content में अपने प्रोजेक्ट में खींचें. अगर कहा जाए, तो आइटम कॉपी करें को चुनें.डाउनलोड किए गए
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 टैब खोलें. अन्य लिंकर फ़्लैग सेक्शन में, डीबग और रिलीज़, दोनों के लिए
-ObjCजोड़ें.अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को बुनियादी से बदलकर सभी पर सेट करें.
Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना
Apple के हिसाब से, App Store पर मौजूद ऐप्लिकेशन के लिए, ऐप्लिकेशन की निजता से जुड़ी जानकारी देना ज़रूरी है. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store पर निजता की जानकारी वाले पेज पर जाएं.
Apple की Privacy Manifest फ़ाइल, एसडीके के रिसॉर्स बंडल में शामिल होती है. यह पुष्टि करने के लिए कि निजता मेनिफ़ेस्ट फ़ाइल शामिल की गई है और उसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं. इसके बाद, संग्रह से निजता रिपोर्ट जनरेट करें.
आगे क्या करना है
Google Cloud Console प्रोजेक्ट को कॉन्फ़िगर करना