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

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

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

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

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

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

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

Swift Package Manager

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

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

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

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

  1. इंस्टॉल करने की पुष्टि करने के लिए, पैकेज की डिपेंडेंसी सेक्शन में जाएं. यह सेक्शन, प्रोजेक्ट नेविगेटर में मौजूद होता है. यहां जाकर, पैकेज और उसके वर्शन की पुष्टि करें.

मैन्युअल तरीके से इंस्टॉल किए गए 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. एसडीके की ये बाइनरी और संसाधन फ़ाइलें डाउनलोड करें:
  2. Xcode लॉन्च करें और कोई मौजूदा प्रोजेक्ट खोलें या नया प्रोजेक्ट बनाएं. अगर iOS का इस्तेमाल पहली बार किया जा रहा है, तो नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.
  3. प्रोजेक्ट से, Maps, Navigation, और Places के सभी मौजूदा रेफ़रंस हटाएं.
  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 को डीबग और रिलीज़ , दोनों के लिए जोड़ें. अगर ये सेटिंग नहीं दिखती हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को बेसिक से बदलकर सभी करें.
  11. Info.plist खोलें और ये की-वैल्यू पेयर जोड़ें:
    • की: NSLocationWhenInUseUsageDescription (निजता - इस्तेमाल के दौरान जगह की जानकारी के इस्तेमाल की जानकारी)
      वैल्यू: "इस ऐप्लिकेशन को, बारी-बारी से नेविगेशन की सुविधा देने के लिए, आपकी जगह की जानकारी का इस्तेमाल करने की अनुमति चाहिए."
    • की: NSLocationAlwaysAndWhenInUseUsageDescription (निजता - हमेशा और इस्तेमाल के दौरान जगह की जानकारी के इस्तेमाल की जानकारी)
      वैल्यू: "इस ऐप्लिकेशन को, बारी-बारी से नेविगेशन की सुविधा देने के लिए, आपकी जगह की जानकारी का इस्तेमाल करने की अनुमति चाहिए."

CocoaPods

iOS के लिए Navigation SDK, CocoaPods पॉड के तौर पर उपलब्ध है. CocoaPods, Swift और Objective-C Cocoa प्रोजेक्ट के लिए, ओपन सोर्स डिपेंडेंसी मैनेजर है.

अगर आपके पास CocoaPods टूल नहीं है, तो टर्मिनल से यह कमांड चलाकर, इसे macOS पर इंस्टॉल करें. ज़्यादा जानकारी के लिए, CocoaPods का इस्तेमाल शुरू करने की गाइड देखें.

sudo gem install cocoapods

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

  1. अगर आपके पास अब तक कोई Xcode प्रोजेक्ट नहीं है, तो अभी एक प्रोजेक्ट बनाएं और उसे अपनी स्थानीय मशीन पर सेव करें. अगर iOS डेवलपमेंट में आपकी दिलचस्पी है, तो:
    1. नया प्रोजेक्ट बनाएं.
    2. iOS > ऐप्लिकेशन टेंप्लेट चुनें.
    3. प्रोजेक्ट के विकल्पों वाली स्क्रीन पर:
      1. प्रोजेक्ट का नाम डालें.
      2. बंडल आइडेंटिफ़ायर फ़ील्ड की वैल्यू रिकॉर्ड करें. इस वैल्यू का इस्तेमाल करके, नीचे दिए गए एपीआई पासकोड को सीमित किया जा सकता है.
      3. प्रोजेक्ट इंटरफ़ेस को स्टोरीबोर्ड पर सेट करें.
      4. भाषा को Swift या Objective-C पर सेट करें.
  2. अपने प्रोजेक्ट की डायरेक्ट्री में, Podfile नाम की फ़ाइल बनाएं. इस फ़ाइल में, आपके प्रोजेक्ट की डिपेंडेंसी तय की जाती हैं.
  3. Podfile में बदलाव करें और अपनी डिपेंडेंसी के साथ-साथ उनके वर्शन जोड़ें. यहां एक उदाहरण दिया गया है. इसमें, iOS के लिए Navigation SDK के लिए ज़रूरी डिपेंडेंसी शामिल है: Navigation SDK for iOS: # Cocoapods install reference # 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '10.12.0'
end
    नए वर्शन का पता लगाने के लिए, समय-समय पर pod outdated कमांड ज़रूर चलाएं. ज़रूरत पड़ने पर, नए वर्शन में अपग्रेड करें.
  4. Podfile सेव करें.

  5. एक टर्मिनल खोलें और उस डायरेक्ट्री पर जाएं जिसमें Podfile मौजूद है:

    cd <path-to-project>

  6. pod install कमांड चलाएं. इससे, Podfile में तय किए गए एपीआई के साथ-साथ, उनकी डिपेंडेंसी भी इंस्टॉल हो जाती हैं.

    pod install

  7. Xcode बंद करें. इसके बाद, Xcode लॉन्च करने के लिए, अपने प्रोजेक्ट की .xcworkspace फ़ाइल खोलें (इस पर दो बार क्लिक करें). इसके बाद से, प्रोजेक्ट खोलने के लिए .xcworkspace फ़ाइल का इस्तेमाल करना ज़रूरी है.

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

  1. एक टर्मिनल खोलें और उस प्रोजेक्ट डायरेक्ट्री पर जाएं जिसमें Podfile मौजूद है.
  2. pod update कमांड चलाएं. इससे, Podfile में तय किए गए सभी एपीआई , नए वर्शन में अपडेट हो जाते हैं.

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

यहां दिए गए उदाहरणों से पता चलता है कि 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 में ट्यूटोरियल उपलब्ध हैं. इनकी मदद से, ऐप्लिकेशन बनाना शुरू किया जा सकता है. ज़्यादा जानकारी के लिए, ये लेख देखें: