अपने iOS उपभोक्ता ऐप्लिकेशन में, ऑन-डिमांड राइड की सुविधा का इस्तेमाल करने के लिए, Consumer SDK का इस्तेमाल करें. यात्राओं को फ़ॉलो करने के बारे में ज़्यादा जानने और इस सुविधा के बारे में जानकारी पाने के लिए, iOS पर किसी यात्रा को फ़ॉलो करना लेख पढ़ें.
अपने iOS उपभोक्ता ऐप्लिकेशन के लिए Consumer SDK टूल सेट अप करने के लिए, यह तरीका अपनाएं:
- सिस्टम की ज़रूरी शर्तें देखें.
- Consumer SDK टूल पाएं.
- Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करें.
- Google Cloud Console प्रोजेक्ट को कॉन्फ़िगर करना.
- पुष्टि करने वाले टोकन पाना.
- Consumer SDK टूल को शुरू करना.
सिस्टम से जुड़ी ज़रूरी शर्तें देखना
आपके इस्तेमाल किए जा रहे Consumer SDK टूल के वर्शन की ज़रूरी शर्तों के लिए, रिलीज़ नोट देखें. प्रॉडक्ट की जानकारी देखें.
- आपके मोबाइल डिवाइस पर iOS 14 या उसके बाद का वर्शन होना चाहिए.
- Apple Xcode का 15 या इसके बाद का वर्शन.
Consumer SDK टूल पाना
CocoaPods की मदद से, Consumer SDK टूल को इंस्टॉल और कॉन्फ़िगर किया जाता है.
Swift Package Manager
Consumer SDK टूल को Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. SDK टूल जोड़ने के लिए, पक्का करें कि आपने Consumer SDK टूल की सभी मौजूदा डिपेंडेंसी हटा दी हों.
किसी नए या मौजूदा प्रोजेक्ट में SDK टूल जोड़ने के लिए, यह तरीका अपनाएं:
-
Xcode
project
याworkspace
खोलें. इसके बाद, फ़ाइल > पैकेज की डिपेंडेंसी जोड़ें पर जाएं. - यूआरएल के तौर पर https://github.com/googlemaps/ios-consumer-sdk डालें. इसके बाद, पैकेज को इंपोर्ट करने के लिए Enter दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
-
किसी खास
version
को इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन पर आधारित विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप "सटीक वर्शन" विकल्प का इस्तेमाल करके, सबसे नया वर्शन डालें. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें.
किसी मौजूदा प्रोजेक्ट के लिए package
को अपडेट करने के लिए, यह तरीका अपनाएं:
- इंस्टॉल की पुष्टि करने के लिए, Project Navigator के पैकेज की डिपेंडेंसी सेक्शन पर जाएं और पैकेज और उसके वर्शन की पुष्टि करें.
मैन्युअल तरीके से इंस्टॉल किए गए मौजूदा Consumer SDK को हटाने के लिए, यह तरीका अपनाएं:
Xcode प्रोजेक्ट की कॉन्फ़िगरेशन सेटिंग में जाकर, फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट ढूंढें. यहां दिए गए फ़्रेमवर्क को हटाने के लिए, माइनस के निशान
(-)
का इस्तेमाल करें:GoogleRidesharingConsumer.xcframework
अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री से,
GoogleRidesharingConsumer
बंडल हटाएं.
CocoaPods का इस्तेमाल करना
CocoaPods टूल इंस्टॉल करना: टर्मिनल विंडो खोलें और यह कमांड चलाएं:
sudo gem install cocoapods
ज़्यादा जानकारी के लिए, CocoaPods का इस्तेमाल शुरू करने के बारे में गाइड देखें.
Consumer SDK टूल के लिए Podfile बनाएं: एपीआई और उसकी डिपेंडेंसी को इंस्टॉल करने के लिए, Podfile का इस्तेमाल किया जाता है.
अपनी प्रोजेक्ट डायरेक्ट्री में
Podfile
नाम की फ़ाइल बनाएं. इस फ़ाइल में, आपके प्रोजेक्ट की डिपेंडेंसी के बारे में जानकारी होती है.Podfile में बदलाव करें और अपनी डिपेंडेंसी जोड़ें. यहां एक उदाहरण दिया गया है, जिसमें डिपेंडेंसी शामिल हैं:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingConsumer' end
Podfile सेव करना: टर्मिनल खोलें और उस फ़ोल्डर पर जाएं जिसमें Podfile मौजूद है:
cd <path-to-project>
pod install कमांड चलाएं: यह कमांड, Podfile में बताए गए एपीआई के साथ-साथ उनकी सभी डिपेंडेंसी भी इंस्टॉल करता है.
pod install
Xcode में अपना प्रोजेक्ट खोलना: Xcode को बंद करें. इसके बाद, Xcode को लॉन्च करने के लिए, अपने प्रोजेक्ट की .xcworkspace फ़ाइल को खोलें (दो बार क्लिक करें). प्रोजेक्ट को बाद में खोलने के लिए, .xcworkspace फ़ाइल का इस्तेमाल करें.
मैन्युअल तरीके से इंस्टॉल करना
इस गाइड में, अपने प्रोजेक्ट में Consumer SDK टूल वाले XCFramework को मैन्युअल तरीके से जोड़ने और Xcode में अपनी बिल्ड सेटिंग को कॉन्फ़िगर करने का तरीका बताया गया है.
इस गाइड का पालन करने से पहले, ये काम करें:
XCFramework डाउनलोड करें. यह एक बाइनरी पैकेज है, जिसका इस्तेमाल Consumer SDK टूल को इंस्टॉल करने के लिए किया जाता है. इस पैकेज का इस्तेमाल कई प्लैटफ़ॉर्म पर किया जा सकता है. इनमें M1 चिपसेट का इस्तेमाल करने वाली मशीनें भी शामिल हैं.
Maps SDK इंस्टॉल करें.
SDK टूल का बाइनरी और संसाधन डाउनलोड करें:
XCFramework और संसाधनों को ऐक्सेस करने के लिए, ज़िप की गई फ़ाइलों को अनपैक करें.
Xcode शुरू करें और कोई प्रोजेक्ट खोलें या बनाएं. अगर आपने पहले कभी iOS ऐप्लिकेशन नहीं बनाया है, तो नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.
अगर आपके प्रोजेक्ट ग्रुप में फ़्रेमवर्क ग्रुप नहीं है, तो उसे बनाएं.
डाउनलोड की गई
gRPCCertificates.bundle
फ़ाइल को खींचकर, अपने Xcode प्रोजेक्ट की टॉप-लेवल डायरेक्ट्री में ले जाएं. अगर कहा जाए, तो आइटम कॉपी करें चुनें.Consumer SDK टूल इंस्टॉल करने के लिए,
GoogleRidesharingConsumer.xcframework
फ़ाइल को फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किए गए कॉन्टेंट में जाकर, अपने प्रोजेक्ट में खींचें और छोड़ें. अगर कहा जाए, तो आइटम कॉपी करें चुनें.डाउनलोड किए गए
GoogleRidesharingConsumer.bundle
को अपने Xcode प्रोजेक्ट की टॉप-लेवल डायरेक्ट्री में खींचें और छोड़ें. अगर कहा जाए, तो आइटम कॉपी करें चुनें.प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें और अपने ऐप्लिकेशन का टारगेट चुनें.
बिल्ड फ़ेज़ टैब खोलें. इसके बाद, लाइब्रेरी के साथ बाइनरी लिंक करें में जाकर, अगर ये फ़्रेमवर्क और लाइब्रेरी पहले से मौजूद नहीं हैं, तो उन्हें जोड़ें:
Accelerate.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
Metal.framework
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें और बिल्ड सेटिंग टैब खोलें. अन्य लिंकर फ़्लैग सेक्शन में, डिबग और रिलीज़, दोनों के लिए
-ObjC
जोड़ें.अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में फ़िल्टर को बुनियादी से सभी पर बदलें.
Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना
Apple के हिसाब से, App Store पर मौजूद ऐप्लिकेशन के लिए निजता से जुड़ी जानकारी देना ज़रूरी है. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store के निजता नीति के ब्यौरे वाले पेज पर जाएं.
Apple की प्राइवसी मेनिफ़ेस्ट फ़ाइल, SDK टूल के संसाधन बंडल में शामिल होती है. निजता मेनिफ़ेस्ट फ़ाइल को शामिल किए जाने की पुष्टि करने और उसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं और संग्रह से निजता रिपोर्ट जनरेट करें.