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. इंस्टॉलेशन की पुष्टि करने के लिए, अपने टारगेट के General पैनल पर जाएं. 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. एसडीके की इन बाइनरी और संसाधन फ़ाइलों को डाउनलोड करें:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Xcode लॉन्च करें. इसके बाद, कोई मौजूदा प्रोजेक्ट खोलें या नया प्रोजेक्ट बनाएं. अगर आपने iOS का इस्तेमाल पहले कभी नहीं किया है, तो एक नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.
3. प्रोजेक्ट से Maps, Navigation, और Places के सभी मौजूदा रेफ़रंस हटाएं.
   अहम जानकारी: Places SDK for iOS, 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. किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें. इसके बाद, बिल्ड सेटिंग टैब खोलें. Other Linker Flags सेक्शन में, debug और release, दोनों के लिए ‑ObjC जोड़ें. अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में जाकर, फ़िल्टर को बेसिक से सभी पर सेट करें.
    अहम जानकारी: एसडीके में 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 (निजता - जगह की जानकारी हमेशा और इस्तेमाल के दौरान इस्तेमाल करने की जानकारी)
      वैल्यू: "इस ऐप्लिकेशन को रास्ते के दिशा-निर्देश के लिए, आपकी जगह की जानकारी इस्तेमाल करने की अनुमति चाहिए."

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

यहां दिए गए उदाहरणों में, 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 की Privacy Manifest फ़ाइल, एसडीके के रिसॉर्स बंडल में शामिल होती है. यह पुष्टि करने के लिए कि प्राइवसी मेनिफ़ेस्ट फ़ाइल को शामिल किया गया है और उसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं. इसके बाद, संग्रह से निजता रिपोर्ट जनरेट करें.

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

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

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

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

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