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

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

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

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

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

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

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

Swift Package Manager

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

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

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

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

1. Xcode में, File > Packages > Update To Latest Package Versions पर जाएं.
2. इंस्टॉल किए गए पैकेज की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. यहां पैकेज और उसके वर्शन की पुष्टि करें.

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

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

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

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

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

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

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 के एक ही वर्शन को डाउनलोड और इंस्टॉल करें. Places SDK for iOS इंस्टॉल करना लेख पढ़ें.
4. Maps और Navigation SDK, दोनों को इंस्टॉल करने के लिए, नीचे दिए गए XCFrameworks को अपने प्रोजेक्ट में Frameworks, Libraries, and Embedded Content में जाकर खींचें और छोड़ें. जब आपसे पूछा जाए, तो Copy items if needed को चुनें:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. आपने जो GoogleMapsResources डाउनलोड किया है उसमें से GoogleMaps.bundle को खींचकर अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में छोड़ें. जब कहा जाए, तब पक्का करें कि ज़रूरत पड़ने पर आइटम कॉपी करें विकल्प चुना गया हो.
6. आपने जो GoogleNavigationResources डाउनलोड किया है उससे GoogleNavigation.bundle को खींचकर अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में छोड़ें. जब आपसे पूछा जाए, तो पक्का करें कि आइटम को डेस्टिनेशन ग्रुप के फ़ोल्डर में कॉपी करें चुना गया हो.
7. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें. इसके बाद, अपने ऐप्लिकेशन का टारगेट चुनें.
8. Build Phases टैब खोलें. इसके बाद, Link Binary with Libraries में जाकर, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें:
   • 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. अपने ऐप्लिकेशन के टारगेट में, Capabilities टैब चुनें. Background Modes को चालू करें और इन मोड को चालू करें:
   • ऑडियो, AirPlay, और पिक्चर में पिक्चर की सुविधा
   • जगह की जानकारी से जुड़े अपडेट
10. किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें. इसके बाद, बिल्ड सेटिंग टैब खोलें. अन्य लिंकर फ़्लैग सेक्शन में जाकर, debug और release, दोनों के लिए ‑ObjC जोड़ें. अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को सामान्य से सभी पर बदलें.
    अहम जानकारी: एसडीके में Swift सिंबल शामिल हैं. अगर आपको सिर्फ़ Objective-C प्रोजेक्ट बनाना है, तो आपको अपने प्रोजेक्ट में एक खाली .swift फ़ाइल भी बनानी होगी. इसके अलावा, Xcode प्रोजेक्ट के Other Linker Flags सेक्शन में यह कोड जोड़ना होगा.

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

11. Info.plist खोलें और यहां दिए गए की-वैल्यू पेयर जोड़ें:
    • कुंजी: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      वैल्यू: "इस ऐप्लिकेशन को, रास्ते के दिशा-निर्देश की सुविधा देने के लिए, आपकी जगह की जानकारी का इस्तेमाल करने की अनुमति चाहिए."
    • कुंजी: 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 की Privacy Manifest फ़ाइल की जांच करना

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

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

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

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

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

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

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

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