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

Swift Package Manager

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

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

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

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

1. अगर आपको 9.0.0 से पहले के वर्शन से अपग्रेड करना है, तो अपग्रेड करने के बाद, आपको इन डिपेंडेंसी को हटाना होगा: GoogleMapsBase, GoogleMapsCore, और GoogleMapsM4B. GoogleMaps के लिए, डिपेंडेंसी न हटाएं. ज़्यादा जानकारी के लिए, वर्शन 9.0.0 के रिलीज़ नोट देखें.

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

   • GoogleMapsBase (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
   • GoogleMapsCore (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
   • GoogleMapsM4B (सिर्फ़ 9.0.0 से पहले के वर्शन से अपग्रेड करने के लिए)
2. Xcode में, "File > Packages > Update To Latest Package Versions" पर जाएं.
3. इंस्टॉल किए गए पैकेज की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. यहां पैकेज और उसके वर्शन की पुष्टि करें.

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

1. Xcode वर्कस्पेस बंद करें. टर्मिनल खोलें और यह कमांड चलाएं:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. अगर CocoaPods के अलावा किसी और काम के लिए Podfile, Podfile.resolved, और Xcode workspace का इस्तेमाल नहीं किया जा रहा है, तो इन्हें हटा दें.

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

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

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

1. एसडीके की इन बाइनरी और संसाधन फ़ाइलों को डाउनलोड करें:
   • GoogleMaps
   • GoogleMapsResources
2. XCFrameworks और संसाधनों को ऐक्सेस करने के लिए, फ़ाइलों को एक्सट्रैक्ट करें.
3. अगर आपके पास अब तक कोई Xcode प्रोजेक्ट नहीं है, तो अभी एक प्रोजेक्ट बनाएं और उसे अपनी लोकल मशीन पर सेव करें. अगर आपको iOS डेवलपमेंट के बारे में ज़्यादा जानकारी नहीं है, तो:
   1. नया प्रोजेक्ट बनाएं.
   2. iOS > ऐप्लिकेशन टेंप्लेट चुनें.
   3. प्रोजेक्ट के विकल्पों वाली स्क्रीन पर:
      1. प्रोजेक्ट का नाम डालें.
      2. बंडल आइडेंटिफ़ायर फ़ील्ड की वैल्यू रिकॉर्ड करें. इस वैल्यू का इस्तेमाल करके, यहां दी गई एपीआई कुंजी को सीमित किया जा सकता है.
      3. प्रोजेक्ट के इंटरफ़ेस को स्टोरीबोर्ड पर सेट करें.
      4. भाषा को Swift या Objective-C पर सेट करें.
4. सामान्य टैब खोलें. नीचे दिए गए XCFrameworks को अपने प्रोजेक्ट में Frameworks, Libraries, and Embedded Content में जाकर खींचें और छोड़ें. पक्का करें कि आपने एम्बेड न करें चुना हो:
   • GoogleMaps.xcframework
5. आपने जो GoogleMapsResources डाउनलोड किया है उससे GoogleMaps.bundle को कॉपी करके, अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में चिपकाएं. जब आपसे पूछा जाए, तब आइटम को डेस्टिनेशन ग्रुप के फ़ोल्डर में कॉपी करें को चुनना न भूलें.
6. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें. इसके बाद, अपने ऐप्लिकेशन का टारगेट चुनें.
7. अपने ऐप्लिकेशन के टारगेट के लिए, Build Phases टैब खोलें. Link Binary with Libraries में जाकर, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • OpenGLES.framework (सिर्फ़ तब, जब OpenGL का इस्तेमाल किया जा रहा हो)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें. इसके बाद, Build Settings टैब खोलें. Linking - General -> Other Linker Flags सेक्शन में, "Debug" और "Release" में -ObjC जोड़ें. अगर ये सेटिंग नहीं दिखती हैं, तो बिल्ड सेटिंग बार में जाकर, फ़िल्टर को सामान्य से सभी पर सेट करें.

9. Places SDK for iOS XCFramework इंस्टॉल करने के लिए, Places SDK for iOS का इस्तेमाल शुरू करें लेख पढ़ें.

CocoaPods

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

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

sudo gem install cocoapods

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

1. अगर आपके पास अब तक कोई Xcode प्रोजेक्ट नहीं है, तो अभी एक प्रोजेक्ट बनाएं और उसे अपनी लोकल मशीन पर सेव करें. अगर आपको iOS डेवलपमेंट के बारे में ज़्यादा जानकारी नहीं है, तो:
   1. नया प्रोजेक्ट बनाएं.
   2. iOS > ऐप्लिकेशन टेंप्लेट चुनें.
   3. प्रोजेक्ट के विकल्पों वाली स्क्रीन पर:
      1. प्रोजेक्ट का नाम डालें.
      2. बंडल आइडेंटिफ़ायर फ़ील्ड की वैल्यू रिकॉर्ड करें. इस वैल्यू का इस्तेमाल करके, यहां दी गई एपीआई कुंजी को सीमित किया जा सकता है.
      3. प्रोजेक्ट के इंटरफ़ेस को स्टोरीबोर्ड पर सेट करें.
      4. भाषा को Swift या Objective-C पर सेट करें.
2. अपने प्रोजेक्ट डायरेक्ट्री में Podfile नाम की फ़ाइल बनाएं. इस फ़ाइल में, आपके प्रोजेक्ट की डिपेंडेंसी के बारे में बताया गया है.
3. Podfile में बदलाव करें और अपनी डिपेंडेंसी के साथ-साथ उनके वर्शन जोड़ें. यहां एक उदाहरण दिया गया है. इसमें iOS के लिए Maps SDK टूल के लिए ज़रूरी डिपेंडेंसी शामिल है:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleMaps', '10.14.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 में बताए गए सभी एपीआई, नए वर्शन में अपडेट हो जाते हैं.

Swift

अपनी एपीआई कुंजी को AppDelegate.swift में इस तरह जोड़ें:

1. यह इंपोर्ट स्टेटमेंट जोड़ें:

   import GoogleMaps

2. अपनी एपीआई कुंजी का इस्तेमाल करके, अपने application(_:didFinishLaunchingWithOptions:) तरीके में यह जोड़ें:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. अगर Places API का भी इस्तेमाल किया जा रहा है, तो अपनी कुंजी को फिर से जोड़ें. इसके लिए, यहां दिया गया तरीका अपनाएं:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

अपनी एपीआई कुंजी को AppDelegate.m में इस तरह जोड़ें:

1. यह इंपोर्ट स्टेटमेंट जोड़ें:

   @import GoogleMaps;

2. अपनी एपीआई कुंजी का इस्तेमाल करके, अपने application:didFinishLaunchingWithOptions: तरीके में यह जोड़ें:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. अगर Places API का भी इस्तेमाल किया जा रहा है, तो अपनी कुंजी को फिर से जोड़ें. इसके लिए, यहां दिया गया तरीका अपनाएं:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];