Xcode प्रोजेक्ट सेट अप करना

बिलिंग की सुविधा चालू करने और एपीआई पासकोड बनाने के बाद, अब Xcode प्रोजेक्ट सेट अप किया जा सकता है. इस प्रोजेक्ट का इस्तेमाल, ऐप्लिकेशन डेवलप करने के लिए किया जाता है.

हर रिलीज़ के लिए, रिलीज़ नोट उपलब्ध होते हैं.

पहला चरण: ज़रूरी सॉफ़्टवेयर इंस्टॉल करना

iOS के लिए Navigation SDK का इस्तेमाल करके कोई प्रोजेक्ट बनाने के लिए, आपको ये चीज़ें डाउनलोड और इंस्टॉल करनी होंगी:

• Xcode वर्शन 26.0 या इसके बाद वाला वर्शन

दूसरा चरण: Xcode प्रोजेक्ट बनाना और Navigation SDK इंस्टॉल करना

Swift Package Manager

Swift Package Manager की मदद से, Navigation SDK इंस्टॉल किया जा सकता है. एसडीके जोड़ने के लिए, पक्का करें कि आपने Navigation SDK की मौजूदा डिपेंडेंसी हटा दी हों.

किसी नए या मौजूदा प्रोजेक्ट में एसडीके जोड़ने के लिए, यह तरीका अपनाएं:

1. अपना Xcode project या workspace खोलें. इसके बाद, फ़ाइल > पैकेज की डिपेंडेंसी जोड़ें पर जाएं.
2. यूआरएल के तौर पर https://github.com/googlemaps/ios-navigation-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
3. कोई खास version इंस्टॉल करने के लिए, डिपेंडेंसी का नियम फ़ील्ड को वर्शन के हिसाब से किसी एक विकल्प पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप सबसे नया वर्शन डालें और "ठीक यही वर्शन" विकल्प का इस्तेमाल करें. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.
4. पैकेज के प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि GoogleNavigation को आपके तय किए गए main टारगेट में जोड़ा जाएगा. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.
5. इंस्टॉल करने की पुष्टि करने के लिए, अपने टारगेट के सामान्य पैन पर जाएं. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में, आपको इंस्टॉल किए गए पैकेज दिखने चाहिए. पैकेज और उसके वर्शन की पुष्टि करने के लिए, "प्रोजेक्ट नेविगेटर" के "पैकेज की डिपेंडेंसी" सेक्शन को भी देखा जा सकता है.

किसी मौजूदा प्रोजेक्ट के लिए package अपडेट करने के लिए, यह तरीका अपनाएं:

1. Xcode में, फ़ाइल > पैकेज > पैकेज के सबसे नए वर्शन पर अपडेट करें पर जाएं.
2. इंस्टॉल करने की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज की डिपेंडेंसी सेक्शन में जाकर, पैकेज और उसके वर्शन की पुष्टि करें.

अहम जानकारी: कभी-कभी, आर्टफ़ैक्ट को हल नहीं किया जा सकता या गड़बड़ियां हो सकती हैं. ऐसे में, "फ़ाइल > पैकेज > पैकेज का कैश रीसेट करें" को चुनें.

iOS के लिए, मैन्युअल तरीके से इंस्टॉल किए गए मौजूदा Navigation SDK को हटाने के लिए, यह तरीका अपनाएं:

1. अपने Xcode प्रोजेक्ट की कॉन्फ़िगरेशन सेटिंग में जाकर, फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट ढूंढें. यहां दिया गया फ़्रेमवर्क हटाने के लिए, माइनस साइन(-) का इस्तेमाल करें:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री से, GoogleMaps बंडल हटाएं.

मैन्युअल तरीके से इंस्टॉल करना

इस गाइड में, iOS के लिए Navigation SDK और iOS के लिए Maps SDK वाले XCFramework को अपने प्रोजेक्ट में मैन्युअल तरीके से जोड़ने और Xcode में अपनी बिल्ड सेटिंग कॉन्फ़िगर करने का तरीका बताया गया है. XCFramework, बाइनरी पैकेज होता है. इसका इस्तेमाल कई प्लैटफ़ॉर्म पर किया जा सकता है. इनमें M1 चिपसेट का इस्तेमाल करने वाली मशीनें भी शामिल हैं

iOS के लिए Navigation SDK और iOS के लिए Maps SDK के XCFramework इंस्टॉल करने के लिए, यह तरीका अपनाएं:

1. एसडीके की ये बाइनरी और संसाधन फ़ाइलें डाउनलोड करें:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Xcode लॉन्च करें और कोई मौजूदा प्रोजेक्ट खोलें या नया प्रोजेक्ट बनाएं. अगर आपने iOS का इस्तेमाल पहले कभी नहीं किया है, तो नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.
3. प्रोजेक्ट से, Maps, Navigation, और Places के सभी मौजूदा रेफ़रंस हटाएं.
   अहम जानकारी: iOS के लिए Places SDK, iOS के लिए Navigation SDK के साथ शामिल नहीं है. इसे अलग से इंस्टॉल करना होगा. यह जानकारी, iOS के लिए Places SDK के वर्शन 5.0 के हिसाब से सही है. Google का सुझाव है कि iOS के लिए Places SDK और iOS के लिए Navigation SDK के एक ही वर्शन डाउनलोड और इंस्टॉल करें. iOS के लिए Places SDK इंस्टॉल करना लेख पढ़ें.
4. Maps और Navigation SDK, दोनों को इंस्टॉल करने के लिए, इन XCFramework को फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में अपने प्रोजेक्ट में खींचें और छोड़ें. अगर कहा जाए, तो ज़रूरत पड़ने पर आइटम कॉपी करें को चुनें:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. डाउनलोड किए गए GoogleMapsResources से, GoogleMaps.bundle को अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में खींचें और छोड़ें. अगर कहा जाए, पक्का करें कि ज़रूरत पड़ने पर आइटम कॉपी करें को चुना गया हो.
6. डाउनलोड किए गए GoogleNavigationResources से, GoogleNavigation.bundle को अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में खींचें और छोड़ें. अगर कहा जाए, तो पक्का करें कि डेस्टिनेशन ग्रुप के फ़ोल्डर में आइटम कॉपी करें को चुना गया हो.
7. प्रोजेक्ट नेविगेटर में जाकर, अपना प्रोजेक्ट चुनें. इसके बाद, अपने ऐप्लिकेशन का टारगेट चुनें.
8. बिल्ड फ़ेज़ टैब खोलें. इसके बाद, लाइब्रेरी के साथ बाइनरी लिंक करें में जाकर, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CarPlay.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • MapKit.framework
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. अपने ऐप्लिकेशन के टारगेट में जाकर, कैपेबिलिटी टैब चुनें. इसके बाद, बैकग्राउंड मोड चालू करें और ये मोड चालू करें:
   • ऑडियो, AirPlay, और पिक्चर इन पिक्चर
   • जगह की जानकारी के अपडेट
10. कोई खास टारगेट चुनने के बजाय, अपना प्रोजेक्ट चुनें और Build Settings टैब खोलें. अन्य लिंकर फ़्लैग सेक्शन में, ‑ObjC को डीबग और रिलीज़, दोनों के लिए जोड़ें. अगर ये सेटिंग नहीं दिखती हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को बेसिक से बदलकर सभी करें.
    अहम जानकारी: एसडीके में Swift सिंबल शामिल हैं. अगर सिर्फ़ Objective-C प्रोजेक्ट बनाया जा रहा है, तो आपको अपने प्रोजेक्ट में एक खाली .swift फ़ाइल भी बनानी होगी. इसके अलावा, Xcode प्रोजेक्ट के अन्य लिंकर फ़्लैग सेक्शन में यह कोड जोड़ना होगा.

    -L$(DEVELOPER_DIR)/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/$(PLATFORM_NAME)

11. Info.plist खोलें और ये की-वैल्यू पेयर जोड़ें:
    • कुंजी: NSLocationWhenInUseUsageDescription (निजता - इस्तेमाल के दौरान जगह की जानकारी के इस्तेमाल की जानकारी)
      वैल्यू: "इस ऐप्लिकेशन को, रास्ते के दिशा-निर्देश की सुविधा देने के लिए, आपकी जगह की जानकारी का इस्तेमाल करने की अनुमति चाहिए."
    • कुंजी: NSLocationAlwaysAndWhenInUseUsageDescription (निजता - हमेशा और इस्तेमाल के दौरान जगह की जानकारी के इस्तेमाल की जानकारी)
      वैल्यू: "इस ऐप्लिकेशन को, रास्ते के दिशा-निर्देश की सुविधा देने के लिए, आपकी जगह की जानकारी का इस्तेमाल करने की अनुमति चाहिए."

तीसरा चरण: प्रोजेक्ट में एपीआई पासकोड जोड़ना

यहां दिए गए उदाहरणों से पता चलता है कि Xcode में अपने प्रोजेक्ट में एपीआई पासकोड कैसे जोड़ा जाता है:

Swift

अपने AppDelegate.swift में, इस तरह एपीआई पासकोड जोड़ें:

1. इंपोर्ट के ये स्टेटमेंट जोड़ें:

   import GoogleMaps
   import GoogleNavigation

2. अपने application(_:didFinishLaunchingWithOptions:) तरीके में यह कोड जोड़ें:

   GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

अपने AppDelegate.m में, इस तरह एपीआई पासकोड जोड़ें:

1. इंपोर्ट के ये स्टेटमेंट जोड़ें:

   @import GoogleMaps;
   @import GoogleNavigation;

2. अपने application:didFinishLaunchingWithOptions: तरीके में यह कोड जोड़ें:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

चौथा चरण (ज़रूरी नहीं): Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना

ध्यान दें: यह जानकारी, वेब स्टोर पर अपना ऐप्लिकेशन डिप्लॉय करने पर लागू होती है.

Apple की यह शर्त है कि App Store पर मौजूद ऐप्लिकेशन के लिए, निजता से जुड़ी जानकारी उपलब्ध कराई जाए. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store Privacy Details पेज पर जाएं.

एसडीके के रिसॉर्स बंडल में, Apple की निजता मेनिफ़ेस्ट फ़ाइल शामिल होती है. यह पुष्टि करने के लिए कि निजता मेनिफ़ेस्ट फ़ाइल शामिल की गई है या नहीं और उसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं. इसके बाद, संग्रह से निजता रिपोर्ट जनरेट करें.

अगर आप Mobility Services के ग्राहक हैं

अगर आप Mobility Services के ग्राहक हैं, तो बिलिंग के बारे में जानने के लिए, Mobility के दस्तावेज़ पढ़ें. लेन-देन रिकॉर्ड करने के बारे में ज़्यादा जानकारी के लिए, बिलिंग सेट अप करना लेख पढ़ें. अपने Navigation SDK के लागू करने में, लेन-देन के आईडी जोड़ने का तरीका जानने के लिए, अपनी सेवा के इस्तेमाल को Mobility के लेन-देन से जोड़ना लेख पढ़ें.

आगे क्या करना है

अब आपके पास एपीआई पासकोड और Xcode प्रोजेक्ट है. इसलिए, ऐप्लिकेशन बनाए और चलाए जा सकते हैं. iOS के लिए Navigation SDK में ट्यूटोरियल उपलब्ध हैं. इनकी मदद से, ऐप्लिकेशन बनाना शुरू किया जा सकता है. ज़्यादा जानकारी के लिए, ये लेख पढ़ें:

• ट्यूटोरियल
  • किसी रास्ते पर नेविगेट करना
  • नेविगेशन इवेंट के बारे में सुनना
• अपने एपीआई पासकोड को सुरक्षित करने के लिए, App Check का इस्तेमाल करना
• कोड सैंपल और कोडलैब