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

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

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

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

Places SDK for iOS का इस्तेमाल करके कोई प्रोजेक्ट बनाने के लिए, आपको इनकी ज़रूरत होगी:

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

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

Swift Package Manager

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

अहम जानकारी: इन निर्देशों में Xcode 15 या इसके बाद के वर्शन का इस्तेमाल किया गया है. हालांकि, Xcode के पिछले वर्शन के लिए भी ये निर्देश मिलते-जुलते होने चाहिए.

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

1. Xcode project या workspace खोलें. इसके बाद, File > Add Package Dependencies पर जाएं.
2. यूआरएल के तौर पर https://github.com/googlemaps/ios-places-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
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. SDK टूल की ये बाइनरी और संसाधन फ़ाइलें डाउनलोड करें:
   • 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.1.0'
     pod 'GooglePlacesSwift', '10.1.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 में बताए गए सभी एपीआई, नए वर्शन में अपडेट हो जाएंगे.

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

यहां दिए गए उदाहरणों में, YOUR_API_KEY की जगह अपनी एपीआई कुंजी डालें.

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

चौथा चरण (ज़रूरी नहीं): Apple की Privacy Manifest फ़ाइल की जांच करना

ध्यान दें: यहां दी गई जानकारी तब काम आती है, जब आपने अपने ऐप्लिकेशन को वेब स्टोर पर डिप्लॉय किया हो.

Apple के हिसाब से यह ज़रूरी है कि App Store पर मौजूद ऐप्लिकेशन के लिए, निजता से जुड़ी जानकारी दी जाए. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store के निजता नीति के ब्यौरे वाले पेज पर जाएं.

Apple की Privacy Manifest फ़ाइल, एसडीके के रिसॉर्स बंडल में शामिल होती है. निजता मेनिफ़ेस्ट फ़ाइल को शामिल किया गया है या नहीं, इसकी पुष्टि करने के लिए अपने ऐप्लिकेशन का संग्रह बनाएं. साथ ही, इसके कॉन्टेंट की जांच करने के लिए, संग्रह से निजता रिपोर्ट जनरेट करें.

अगले चरण

• कोड लिखना शुरू करें. हमारा सुझाव है कि आप एक स्टार्टर ऐप्लिकेशन लागू करें. यह ऐप्लिकेशन, उपयोगकर्ता की मौजूदा जगह की जानकारी हासिल करता है.
• प्रोजेक्ट कॉन्फ़िगर होने के बाद, सैंपल ऐप्लिकेशन देखे जा सकते हैं.
• अपने एपीआई पासकोड को सुरक्षित रखने के लिए, App Check का इस्तेमाल करें.