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

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. इंस्टॉलेशन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. इससे पैकेज और उसके वर्शन की पुष्टि की जा सकेगी.

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

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"];