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 दबाएं और "Add Package" पर क्लिक करें.
3. कोई खास version इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन के हिसाब से उपलब्ध विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप नया वर्शन तय करें और "Exact Version" विकल्प का इस्तेमाल करें. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें.
4. पैकेज प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि GoogleNavigation को आपके तय किए गए main टारगेट में जोड़ा जाएगा. इसके बाद, "पैकेज जोड़ें" पर क्लिक करें.
5. इंस्टॉलेशन की पुष्टि करने के लिए, अपने टारगेट के सामान्य पैनल पर जाएं. Frameworks, Libraries, and Embedded Content में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, "प्रोजेक्ट नेविगेटर" के "पैकेज डिपेंडेंसी" सेक्शन को भी देखा जा सकता है.

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

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

अहम जानकारी: कभी-कभी, आर्टफ़ैक्ट को रिज़ॉल्व नहीं किया जा सकता या गड़बड़ियां हो सकती हैं. ऐसे में, "File > Packages > Reset Package Cache" को चुनें.

मैन्युअल तरीके से इंस्टॉल किए गए, 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. यहां दी गई SDK बाइनरी और संसाधन फ़ाइलें डाउनलोड करें:
   • 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, दोनों को इंस्टॉल करने के लिए, नीचे दिए गए XCFrameworks को अपने प्रोजेक्ट में फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में खींचें और छोड़ें. इसके बाद, जब आपसे पूछा जाए, तब ज़रूरत पड़ने पर आइटम कॉपी करें को चुनें:
   • 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. किसी खास टारगेट के बजाय अपना प्रोजेक्ट चुनें और Build Settings टैब खोलें. Other Linker Flags सेक्शन में, debug और release, दोनों के लिए ‑ObjC जोड़ें. अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में जाकर, फ़िल्टर को बेसिक से सभी पर सेट करें.
    अहम जानकारी: SDK टूल में Swift सिंबल शामिल हैं. अगर आपको पूरी तरह से Objective-C प्रोजेक्ट बनाना है, तो आपको अपने प्रोजेक्ट में एक खाली .swift फ़ाइल भी बनानी होगी या Xcode प्रोजेक्ट के अन्य लिंकर फ़्लैग सेक्शन में यह जोड़ना होगा.

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

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

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

यहां दिए गए उदाहरणों से पता चलता है कि 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 पर निजता की जानकारी वाले पेज पर जाएं.

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

अगर आप मोबिलिटी सर्विस के ग्राहक हैं

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

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

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

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