iOS पर चलने वाले उपभोक्ता ऐप्लिकेशन में, मांग के हिसाब से की जाने वाली यात्राओं को ट्रैक करने के लिए, Consumer SDK का इस्तेमाल करें. यात्राएं फ़ॉलो करने के बारे में ज़्यादा जानकारी और इसे शुरू करने के लिए, iOS में यात्रा फ़ॉलो करना लेख पढ़ें.
अपने iOS उपभोक्ता ऐप्लिकेशन के लिए Consumer SDK टूल सेट अप करने के लिए, यह तरीका अपनाएं:
- सिस्टम की ज़रूरी शर्तें देखें.
- Consumer SDK टूल पाएं.
- Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करें.
- Google Cloud Console प्रोजेक्ट को कॉन्फ़िगर करें.
- पुष्टि करने वाले टोकन पाना.
- Consumer SDK को शुरू करें.
सिस्टम की ज़रूरी शर्तें देखना
Consumer SDK के जिस वर्शन का इस्तेमाल किया जा रहा है उसके लिए, रिलीज़ नोट में दी गई ज़रूरी शर्तें देखें. प्रॉडक्ट की जानकारी देखें.
- मोबाइल डिवाइस में iOS 16 या इसके बाद का वर्शन होना चाहिए.
- Apple Xcode version 26 या इसके बाद का वर्शन.
Consumer 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को इंस्टॉल करने के लिए, डिपेंडेंसी का नियम फ़ील्ड को वर्शन के आधार पर उपलब्ध विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप सबसे नया वर्शन तय करें और "Exact Version" विकल्प का इस्तेमाल करें. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें. -
पैकेज में शामिल किए जाने वाले प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि
GoogleRidesharingConsumerको आपके चुने गएmainटारगेट में जोड़ दिया जाएगा. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें. - इंस्टॉलेशन की पुष्टि करने के लिए, टारगेट के सामान्य पैनल पर जाएं. आपको फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, "प्रोजेक्ट नेविगेटर" के "पैकेज डिपेंडेंसी" सेक्शन को भी देखा जा सकता है.
किसी मौजूदा प्रोजेक्ट के लिए package अपडेट करने के लिए, यह तरीका अपनाएं:
- Xcode में, File > Packages > Update To Latest Package Versions पर जाएं.
- इंस्टॉल किए गए पैकेज की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. यहां पैकेज और उसके वर्शन की पुष्टि करें.
मैन्युअल तरीके से इंस्टॉल किए गए मौजूदा 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 चिपसेट का इस्तेमाल करने वाली मशीनें भी शामिल हैं.
Maps SDK इंस्टॉल करें.
एसडीके बाइनरी और संसाधन डाउनलोड करें:
XCFramework और संसाधनों को ऐक्सेस करने के लिए, ZIP की गई फ़ाइलों को अनपैक करें.
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.frameworkCoreData.frameworkCoreGraphics.frameworkCoreImage.frameworkCoreLocation.frameworkCoreTelephony.frameworkCoreText.frameworkGLKit.frameworkImageIO.frameworklibc++.tbdlibz.tbdMetal.frameworkOpenGLES.frameworkQuartzCore.frameworkSystemConfiguration.frameworkUIKit.framework
किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें. इसके बाद, बिल्ड सेटिंग टैब खोलें. अन्य लिंकर फ़्लैग सेक्शन में जाकर, डीबग और रिलीज़, दोनों के लिए
-ObjCजोड़ें.अगर ये सेटिंग नहीं दिखती हैं, तो बिल्ड सेटिंग बार में फ़िल्टर को बुनियादी से सभी पर बदलें.
Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना
Apple को App Store पर मौजूद ऐप्लिकेशन के लिए, ऐप्लिकेशन की निजता से जुड़ी जानकारी चाहिए. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store के निजता से जुड़ी जानकारी वाले पेज पर जाएं.
Apple की Privacy Manifest फ़ाइल, एसडीके के रिसॉर्स बंडल में शामिल होती है. यह पुष्टि करने के लिए कि निजता मेनिफ़ेस्ट फ़ाइल शामिल की गई है और उसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं. इसके बाद, संग्रह से निजता रिपोर्ट जनरेट करें.
आगे क्या करना है
Google Cloud Console प्रोजेक्ट को कॉन्फ़िगर करना