iOS पर काम करने वाले अपने उपभोक्ता ऐप्लिकेशन में, मांग के हिसाब से ट्रिप की जानकारी पाने के लिए, Consumer SDK का इस्तेमाल करें. यात्राएं फ़ॉलो करने के बारे में ज़्यादा जानने और इसे आज़माने के लिए, iOS में यात्रा फ़ॉलो करना लेख पढ़ें.
अपने iOS उपभोक्ता ऐप्लिकेशन के लिए Consumer SDK सेट अप करने के लिए, यह तरीका अपनाएं:
- सिस्टम से जुड़ी ज़रूरी शर्तें देखें.
- Consumer SDK टूल पाएं.
- Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करें.
- Google Cloud Console प्रोजेक्ट को कॉन्फ़िगर करें.
- पुष्टि करने वाले टोकन पाना.
- Consumer SDK को शुरू करें.
सिस्टम की ज़रूरी शर्तें देखना
Consumer SDK के जिस वर्शन का इस्तेमाल किया जा रहा है उसके लिए, ज़रूरी शर्तों के बारे में जानकारी देने वाले रिलीज़ नोट देखें. प्रॉडक्ट की जानकारी देखें.
- मोबाइल डिवाइस में iOS 14 या इसके बाद का वर्शन होना चाहिए.
- Apple Xcode version 15 या इसके बाद का वर्शन.
उपयोगकर्ता के लिए उपलब्ध SDK टूल पाना
Consumer SDK को CocoaPods की मदद से इंस्टॉल और कॉन्फ़िगर किया जाता है.
Swift Package Manager
Consumer SDK को Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. एसडीके टूल जोड़ने के लिए, पक्का करें कि आपने Consumer SDK की सभी मौजूदा डिपेंडेंसी हटा दी हों.
किसी नए या मौजूदा प्रोजेक्ट में SDK टूल जोड़ने के लिए, यह तरीका अपनाएं:
-
Xcode
project
याworkspace
खोलें. इसके बाद, File > Add Package Dependencies पर जाएं. - यूआरएल के तौर पर https://github.com/googlemaps/ios-consumer-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "Add Package" पर क्लिक करें.
-
किसी खास
version
को इंस्टॉल करने के लिए, Dependency Rule फ़ील्ड को वर्शन के आधार पर उपलब्ध विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप नए वर्शन के बारे में बताएं और "Exact Version" विकल्प का इस्तेमाल करें. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.
किसी मौजूदा प्रोजेक्ट के लिए package
अपडेट करने के लिए, यह तरीका अपनाएं:
- इंस्टॉल करने की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. यहां पैकेज और उसके वर्शन की पुष्टि करें.
मैन्युअल तरीके से इंस्टॉल किए गए मौजूदा Consumer SDK को हटाने के लिए, यह तरीका अपनाएं:
Xcode प्रोजेक्ट कॉन्फ़िगरेशन सेटिंग में जाकर, Frameworks, Libraries, and Embedded Content ढूंढें. नीचे दिए गए फ़्रेमवर्क को हटाने के लिए, माइनस के निशान
(-)
का इस्तेमाल करें: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
फ़ाइल को अपने प्रोजेक्ट में Frameworks, Libraries, and Embedded Content में जाकर खींचें और छोड़ें. अगर कहा जाए, तो आइटम कॉपी करें चुनें.डाउनलोड किए गए
GoogleRidesharingConsumer.bundle
को अपने Xcode प्रोजेक्ट की टॉप-लेवल डायरेक्ट्री में खींचें और छोड़ें. अगर कहा जाए, तो आइटम कॉपी करें चुनें.प्रोजेक्ट नेविगेटर में जाकर अपना प्रोजेक्ट चुनें. इसके बाद, अपने ऐप्लिकेशन का टारगेट चुनें.
Build Phases टैब खोलें. इसके बाद, Link Binary with Libraries में जाकर, अगर ये फ़्रेमवर्क और लाइब्रेरी पहले से मौजूद नहीं हैं, तो इन्हें जोड़ें:
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
किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें. इसके बाद, Build Settings टैब खोलें. Other Linker Flags सेक्शन में जाकर, डीबग और रिलीज़, दोनों के लिए
-ObjC
जोड़ें.अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को बेसिक से सभी पर बदलें.
Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना
Apple के हिसाब से यह ज़रूरी है कि App Store पर मौजूद ऐप्लिकेशन के लिए, निजता से जुड़ी जानकारी दी जाए. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store के निजता नीति के ब्यौरे वाले पेज पर जाएं.
Apple की Privacy Manifest फ़ाइल, एसडीके के रिसॉर्स बंडल में शामिल होती है. निजता मेनिफ़ेस्ट फ़ाइल को शामिल किया गया है या नहीं, इसकी पुष्टि करने के लिए अपने ऐप्लिकेशन का संग्रह बनाएं. साथ ही, इसके कॉन्टेंट की जांच करने के लिए, संग्रह से निजता रिपोर्ट जनरेट करें.
आगे क्या करना है
Google Cloud Console प्रोजेक्ट को कॉन्फ़िगर करना