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

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

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

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

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

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

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

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 इंस्टॉल करने के लिए, डिपेंडेंसी नियम फ़ील्ड को वर्शन पर आधारित किसी विकल्प पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप नया वर्शन चुनें और "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. इंस्टॉलेशन की पुष्टि करने के लिए, अपने टारगेट के सामान्य पैनल पर जाएं. Frameworks, Libraries, and Embedded Content में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, Project Navigator के Package Dependencies सेक्शन को भी देखा जा सकता है.

किसी मौजूदा प्रोजेक्ट के लिए 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 टूल की ये बाइनरी और रिसॉर्स फ़ाइलें डाउनलोड करें:
  2. अगर iOS के लिए Places Swift SDK इंस्टॉल किया जा रहा है, तो ये फ़ाइलें इंस्टॉल करें:
  3. XCFramework और संसाधनों को ऐक्सेस करने के लिए, फ़ाइलों को एक्सट्रैक्ट करें.
  4. Xcode लॉन्च करें और कोई मौजूदा प्रोजेक्ट खोलें या नया प्रोजेक्ट बनाएं. अगर आप iOS डेवलपमेंट में नए हैं, तो एक नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.
  5. अपने प्रोजेक्ट से, पिछली रिलीज़ के सभी Maps बंडल हटाएं.
  6. सामान्य टैब खोलें. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किए गए कॉन्टेंट में जाकर, इस XCFramework को अपने प्रोजेक्ट में खींचें और छोड़ें. पक्का करें कि आपने एंबेड न करें को चुना हो:
    • GooglePlaces.xcframework
    अगर Places Swift SDK इंस्टॉल किया जा रहा है, तो फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किए गए कॉन्टेंट में जाकर, इस XCFramework को अपने प्रोजेक्ट में खींचें और छोड़ें. पक्का करें कि आपने एंबेड न करें को चुना हो:
    • 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 सेक्शन में, "डीबग" और "रिलीज़" में -ObjC जोड़ें. अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में फ़िल्टर को बेसिक से बदलकर सभी पर सेट करें.

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

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

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

अपने 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 की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना

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

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

अगले चरण