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

Swift Package Manager

iOS के लिए Maps SDK को Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. एसडीके जोड़ने के लिए, पक्का करें कि आपने iOS के लिए Maps 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" विकल्प का इस्तेमाल करें. यह चरण पूरा होने के बाद, "Add Package" पर क्लिक करें.
4. Choose Package Products विंडो में, पुष्टि करें कि आपके तय किए गए main टारगेट में GoogleMaps (9.0.0 से पहले के वर्शन के लिए, GoogleMaps, GoogleMapsBase, और GoogleMapsCore की पुष्टि करें) जोड़ा जाएगा. यह चरण पूरा होने के बाद, "Add Package" पर क्लिक करें.
5. इंस्टॉल करने की पुष्टि करने के लिए, अपने टारगेट के General पैन पर जाएं. Frameworks, Libraries, and Embedded Content में, आपको इंस्टॉल किए गए पैकेज दिखने चाहिए. पैकेज और उसके वर्शन की पुष्टि करने के लिए, "Project Navigator" के "Package Dependencies" सेक्शन को भी देखा जा सकता है.

किसी मौजूदा प्रोजेक्ट के लिए, 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. इंस्टॉल करने की पुष्टि करने के लिए, Package Dependencies सेक्शन पर जाएं. यहां पैकेज और उसके वर्शन की पुष्टि करें.

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

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 वाले XCFramework को अपने प्रोजेक्ट में मैन्युअल तरीके से जोड़ने और Xcode में अपने बिल्ड सेटिंग को कॉन्फ़िगर करने का तरीका बताया गया है. XCFramework, बाइनरी पैकेज होता है. इसका इस्तेमाल कई प्लैटफ़ॉर्म पर किया जा सकता है. इनमें Apple सिलिकॉन का इस्तेमाल करने वाली मशीनें भी शामिल हैं.

1. एसडीके की ये बाइनरी और संसाधन फ़ाइलें डाउनलोड करें:
   • GoogleMaps
   • GoogleMapsResources
2. XCFramework और संसाधन ऐक्सेस करने के लिए, फ़ाइलें एक्सट्रैक्ट करें.
3. अगर आपके पास अब तक कोई Xcode प्रोजेक्ट नहीं है, तो अभी एक प्रोजेक्ट बनाएं और उसे अपनी लोकल मशीन पर सेव करें. अगर आपने iOS डेवलपमेंट में अभी-अभी शुरुआत की है, तो:
   1. कोई नया प्रोजेक्ट बनाएं.
   2. iOS > ऐप्लिकेशन टेंप्लेट चुनें.
   3. प्रोजेक्ट के विकल्पों वाली स्क्रीन पर:
      1. प्रोजेक्ट का नाम डालें.
      2. बंडल आइडेंटिफ़ायर फ़ील्ड की वैल्यू रिकॉर्ड करें. इस वैल्यू का इस्तेमाल, नीचे दिए गए एपीआई पासकोड को सीमित करने के लिए किया जा सकता है.
      3. प्रोजेक्ट इंटरफ़ेस को Storyboard पर सेट करें.
      4. भाषा को Swift या Objective-C पर सेट करें.
4. General टैब खोलें. **Frameworks, Libraries, and Embedded Content** में जाकर, ये XCFramework अपने प्रोजेक्ट में खींचें और छोड़ें. Do Not Embed को चुनना न भूलें:
   • GoogleMaps.xcframework
5. डाउनलोड किए गए GoogleMapsResources से, GoogleMaps.bundle को कॉपी करके अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में चिपकाएं. प्रॉम्प्ट मिलने पर, Copy items into destination group's folder को चुनना न भूलें.
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 जोड़ें. अगर ये सेटिंग नहीं दिखती हैं, तो Build Settings बार में फ़िल्टर को Basic से बदलकर All करें.

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

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