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

Swift Package Manager

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

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

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

   अगर आपको Google Places Swift को बंद किए गए GitHub यूआरएल से अपडेट करना है

   अहम जानकारी: Google Places Swift को ऐक्सेस करने के लिए, GitHub का यूआरएल बदल गया है. यह बदलाव, वर्शन 0.3.0 से लागू हुआ है. अगर आपको GooglePlacesSwift के ऐसे वर्शन को अपडेट करना है जिसे पुराने यूआरएल https://github.com/googlemaps/ios-places-swift-sdk से ऐक्सेस किया गया था, तो उसे Xcode के पैकेज डिपेंडेंसी सेक्शन से हटाएं.

5. इंस्टॉलेशन की पुष्टि करने के लिए, टारगेट के सामान्य पैनल पर जाएं. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में, आपको इंस्टॉल किए गए पैकेज दिखने चाहिए. पैकेज और उसके वर्शन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन को भी देखा जा सकता है.

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

1. Xcode में, "File > Packages > Update To Latest Package Versions" पर जाएं.

   अगर आपको Google Places Swift को बंद किए गए GitHub यूआरएल से अपडेट करना है

   अहम जानकारी: Google Places Swift को ऐक्सेस करने के लिए, GitHub का यूआरएल बदल गया है. यह बदलाव, वर्शन 0.3.0 से लागू हुआ है. अगर आपको GooglePlacesSwift के ऐसे वर्शन को अपडेट करना है जिसे पुराने यूआरएल https://github.com/googlemaps/ios-places-swift-sdk से ऐक्सेस किया गया था, तो उसे Xcode के पैकेज डिपेंडेंसी सेक्शन से हटाएं.

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

Places SDK for iOS को मैन्युअल तरीके से इंस्टॉल करने पर, उसे हटाने के लिए यह तरीका अपनाएं:

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

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

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

1. एसडीके की बाइनरी और संसाधन फ़ाइलें डाउनलोड करें:
   • GooglePlaces
   • GooglePlacesResources
2. अगर आपको iOS के लिए Places Swift SDK इंस्टॉल करना है, तो ये फ़ाइलें इंस्टॉल करें:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. XCFramework और संसाधनों को ऐक्सेस करने के लिए, फ़ाइलों को एक्सट्रैक्ट करें.
4. Xcode लॉन्च करें. इसके बाद, कोई मौजूदा प्रोजेक्ट खोलें या नया प्रोजेक्ट बनाएं. अगर आपको iOS डेवलपमेंट के बारे में ज़्यादा जानकारी नहीं है, तो एक नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.
5. अपने प्रोजेक्ट से, पिछली रिलीज़ में मौजूद Maps बंडल हटाएं.
6. सामान्य टैब खोलें. नीचे दिए गए XCFramework को अपने प्रोजेक्ट में Frameworks, Libraries, and Embedded Content में जाकर खींचें और छोड़ें. पक्का करें कि आपने एम्बेड न करें चुना हो:
   • GooglePlaces.xcframework
   अगर Places Swift SDK इंस्टॉल किया जा रहा है, तो नीचे दिए गए XCFramework को अपने प्रोजेक्ट में Frameworks, Libraries, and Embedded Content में जाकर खींचें और छोड़ें. पक्का करें कि आपने एम्बेड न करें चुना हो:
   • GooglePlacesSwift.xcframework
7. आपने जो GooglePlacesResources डाउनलोड किया है उसमें से GooglePlaces.bundle को कॉपी करें. इसके बाद, इसे अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में चिपकाएं. जब आपसे पूछा जाए, तब आइटम को डेस्टिनेशन ग्रुप के फ़ोल्डर में कॉपी करें को चुनना न भूलें.
   
   अगर Places Swift SDK इंस्टॉल किया जा रहा है, तो डाउनलोड किए गए GooglePlacesSwiftResources से GooglePlacesSwift.bundle को कॉपी करके, अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में चिपकाएं. जब आपसे पूछा जाए, तब आइटम को डेस्टिनेशन ग्रुप के फ़ोल्डर में कॉपी करें को चुनना न भूलें.
8. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें. इसके बाद, अपने ऐप्लिकेशन का टारगेट चुनें.
9. Build Phases टैब खोलें. Link Binary with Libraries में जाकर, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

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

CocoaPods

Places SDK for iOS और Places Swift SDK for iOS, CocoaPod पॉड के तौर पर उपलब्ध हैं. ये GooglePlaces और GooglePlacesSwift हैं.

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

sudo gem install cocoapods

एसडीके और उनकी डिपेंडेंसी इंस्टॉल करने के लिए, Podfile बनाएं:

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

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

GooglePlacesSwift

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

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

  import GooglePlacesSwift

• अपने application(_:didFinishLaunchingWithOptions:) तरीके में यह जोड़ें. साथ ही, YOUR_API_KEY को अपने एपीआई पासकोड से बदलें:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

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

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

  import GooglePlaces

• अपने application(_:didFinishLaunchingWithOptions:) तरीके में यह जोड़ें. साथ ही, YOUR_API_KEY को अपने एपीआई पासकोड से बदलें:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

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

  @import GooglePlaces;

• अपने application:didFinishLaunchingWithOptions: तरीके में यह जोड़ें. साथ ही, YOUR_API_KEY को अपने एपीआई पासकोड से बदलें:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];