iOS के उपभोक्ता ऐप्लिकेशन में, ऑन-डिमांड ट्रिप की सुविधा देने के लिए, Consumer SDK का इस्तेमाल करें. ट्रिप की सुविधा देने के बारे में ज़्यादा जानने और इसे शुरू करने के लिए, iOS में ट्रिप की सुविधा देना लेख पढ़ें.
अपने iOS उपभोक्ता ऐप्लिकेशन के लिए, Consumer SDK सेट अप करने के लिए, यह तरीका अपनाएं:
- सिस्टम से जुड़ी ज़रूरी शर्तें देखें.
- Consumer SDK पाएं.
- Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करें.
- Google Cloud Console का प्रोजेक्ट कॉन्फ़िगर करें.
- पुष्टि करने वाले टोकन पाएं.
- Consumer SDK को शुरू करें.
सिस्टम से जुड़ी ज़रूरी शर्तें देखना
Consumer SDK के जिस वर्शन का इस्तेमाल किया जा रहा है उसके लिए, ज़रूरी शर्तें देखने के लिए, रिलीज़ नोट देखें. रिलीज़ नोट देखें.
- मोबाइल डिवाइस पर iOS 16 या उसके बाद का वर्शन होना चाहिए.
- Apple Xcode वर्शन 26 या उसके बाद का वर्शन होना चाहिए.
Consumer SDK पाना
Consumer SDK को CocoaPods की मदद से इंस्टॉल और कॉन्फ़िगर किया जाता है.
Swift Package Manager
Consumer SDK को Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. एसडीके जोड़ने के लिए, पक्का करें कि आपने Consumer SDK की मौजूदा डिपेंडेंसी हटा दी हों.
किसी नए या मौजूदा प्रोजेक्ट में एसडीके जोड़ने के लिए, यह तरीका अपनाएं:
-
अपना Xcode
projectयाworkspaceखोलें. इसके बाद, File > Add Package Dependencies पर जाएं. - यूआरएल के तौर पर https://github.com/googlemaps/ios-consumer-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "Add Package" पर क्लिक करें.
-
कोई खास
versionइंस्टॉल करने के लिए, Dependency Rule फ़ील्ड को वर्शन के हिसाब से किसी एक विकल्प पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि सबसे नया वर्शन तय करें और "Exact Version" विकल्प का इस्तेमाल करें. पूरा होने के बाद, "Add Package" पर क्लिक करें.
किसी मौजूदा प्रोजेक्ट के लिए, package अपडेट करने के लिए, यह तरीका अपनाएं:
- इंस्टॉल करने की पुष्टि करने के लिए, Package Dependencies सेक्शन में जाएं. यह सेक्शन, Project Navigator में मौजूद होता है. यहां जाकर, पैकेज और उसके वर्शन की पुष्टि करें.
मैन्युअल तरीके से इंस्टॉल किए गए मौजूदा 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' endPodfile सेव करना: टर्मिनल खोलें और उस फ़ोल्डर पर जाएं जिसमें Podfile मौजूद है:
cd <path-to-project>
pod install कमांड रन करना: इस कमांड से, Podfile में तय किए गए एपीआई इंस्टॉल हो जाते हैं. साथ ही, उनकी डिपेंडेंसी भी इंस्टॉल हो जाती हैं.
pod installXcode में अपना प्रोजेक्ट खोलना: Xcode बंद करें. इसके बाद, Xcode लॉन्च करने के लिए, अपने प्रोजेक्ट की .xcworkspace फ़ाइल खोलें (इस पर दो बार क्लिक करें) . बाद में प्रोजेक्ट खोलने के लिए, .xcworkspace फ़ाइल का इस्तेमाल करें.
मैन्युअल तरीके से इंस्टॉल करना
इस गाइड में, आपके प्रोजेक्ट में Consumer SDK वाला XCFramework मैन्युअल तरीके से जोड़ने और Xcode में अपने बिल्ड की सेटिंग कॉन्फ़िगर करने का तरीका बताया गया है.
यह गाइड पढ़ने से पहले, यह काम करें:
XCFramework डाउनलोड करें. यह एक बाइनरी पैकेज है, जिसका इस्तेमाल Consumer SDK इंस्टॉल करने के लिए किया जाता है. इस पैकेज का इस्तेमाल, M1 चिपसेट वाले कंप्यूटरों के साथ-साथ कई प्लैटफ़ॉर्म पर किया जा सकता है.
एसडीके बाइनरी और संसाधन डाउनलोड करें:
XCFramework और संसाधन ऐक्सेस करने के लिए, ज़िप की गई फ़ाइलें अनपैक करें.
Xcode शुरू करें और कोई प्रोजेक्ट खोलें या बनाएं. अगर iOS का इस्तेमाल पहली बार किया जा रहा है, तो नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.
अगर आपके प्रोजेक्ट ग्रुप में कोई फ़्रेमवर्क ग्रुप नहीं है, तो उसे बनाएं.
डाउनलोड की गई
gRPCCertificates.bundleफ़ाइल को, अपने Xcode प्रोजेक्ट की टॉप-लेवल डायरेक्ट्री में खींचें. अगर कहा जाए, तो Copy items को चुनें.Consumer SDK इंस्टॉल करने के लिए,
GoogleRidesharingConsumer.xcframeworkफ़ाइल को अपने प्रोजेक्ट में, Frameworks, Libraries, and Embedded Content में खींचें. अगर कहा जाए, तो Copy items को चुनें.डाउनलोड की गई
GoogleRidesharingConsumer.bundleफ़ाइल को, अपने Xcode प्रोजेक्ट की टॉप-लेवल डायरेक्ट्री में खींचें. अगर कहा जाए, तो Copy items को चुनें.प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें. इसके बाद, अपने ऐप्लिकेशन का टारगेट चुनें.
Build Phases टैब खोलें. इसके बाद, Link Binary with Libraries में, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें. हालांकि, अगर ये पहले से मौजूद हैं, तो इन्हें जोड़ने की ज़रूरत नहीं है:
Accelerate.frameworkCoreData.frameworkCoreGraphics.frameworkCoreImage.frameworkCoreLocation.frameworkCoreTelephony.frameworkCoreText.frameworkGLKit.frameworkImageIO.frameworklibc++.tbdlibz.tbdMetal.frameworkOpenGLES.frameworkQuartzCore.frameworkSystemConfiguration.frameworkUIKit.framework
किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें और Build Settings टैब खोलें. Other Linker Flags सेक्शन में, डीबग और रिलीज़, दोनों के लिए
-ObjCजोड़ें.अगर ये सेटिंग नहीं दिखती हैं, तो Build Settings बार में मौजूद फ़िल्टर को Basic से बदलकर All करें.
Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना
Apple के हिसाब से यह ज़रूरी है कि App Store पर मौजूद ऐप्लिकेशन के लिए, ऐप्लिकेशन की निजता से जुड़ी जानकारी दी जाए. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store Privacy Details पेज पर जाएं.
एसडीके के रिसॉर्स बंडल में, Apple की निजता मेनिफ़ेस्ट फ़ाइल शामिल होती है. यह पुष्टि करने के लिए कि निजता मेनिफ़ेस्ट फ़ाइल शामिल की गई है या नहीं और उसकी सामग्री की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं. इसके बाद, संग्रह से निजता रिपोर्ट जनरेट करें.
आगे क्या करना है
Google Cloud Console का प्रोजेक्ट कॉन्फ़िगर करना