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

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

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

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

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

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

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

Swift Package Manager

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

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

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

    Google Places Swift को अपडेट करने पर

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

  5. इंस्टॉलेशन की पुष्टि करने के लिए, अपने टारगेट के सामान्य पैनल पर जाएं. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, Project Navigator के पैकेज की डिपेंडेंसी सेक्शन को भी देखा जा सकता है. Xcode, GitHub वर्शन दिखाता है, जो GooglePlaces के वर्शन (उदाहरण के लिए, 9.2.0) से मेल खाता है, लेकिन GooglePlacesSwift के वर्शन (उदाहरण के लिए, 0.3.0) से मेल नहीं खाता.

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

  1. Xcode में, "फ़ाइल > पैकेज > पैकेज के नए वर्शन पर अपडेट करें" पर जाएं.

    Google Places Swift को अपडेट करने पर

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

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

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

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

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

इस गाइड में, अपने प्रोजेक्ट में Places SDK for iOS और Places Swift SDK for iOS (Preview) वाले XCFrameworks को मैन्युअल तरीके से जोड़ने और Xcode में अपनी बिल्ड सेटिंग कॉन्फ़िगर करने का तरीका बताया गया है. XCFramework एक बाइनरी पैकेज होता है. इसे कई प्लैटफ़ॉर्म पर इस्तेमाल किया जा सकता है. इनमें Apple silicon का इस्तेमाल करने वाली मशीनें भी शामिल हैं. आपके पास 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
    अगर आपको iOS के लिए Places Swift SDK (झलक) इंस्टॉल करना है, तो फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किए गए कॉन्टेंट में जाकर, नीचे दिए गए XCFramework को अपने प्रोजेक्ट में खींचें और छोड़ें. पक्का करें कि आपने एम्बेड न करें को चुना हो:
    • GooglePlacesSwift.xcframework
  7. GooglePlacesResources से GooglePlaces.bundle को कॉपी करके, अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में चिपकाएं. निर्देश मिलने पर, आइटम को डेस्टिनेशन ग्रुप के फ़ोल्डर में कॉपी करें चुनना न भूलें.

    अगर iOS (Preview) के लिए Places Swift SDK इंस्टॉल किया जा रहा है, तो अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में डाउनलोड किए गए GooglePlacesSwiftResources से GooglePlacesSwift.bundle को कॉपी करें. निर्देश मिलने पर, आइटम को डेस्टिनेशन ग्रुप के फ़ोल्डर में कॉपी करें चुनना न भूलें.
  8. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें और अपने ऐप्लिकेशन का टारगेट चुनें.
  9. चरण बनाएं टैब खोलें. बाइनरी को लाइब्रेरी के साथ लिंक करें में जाकर, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework

  10. किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें और बिल्ड सेटिंग टैब खोलें. लिंक करना - सामान्य -> अन्य लिंकर फ़्लैग सेक्शन में, "डीबग" और "रिलीज़ करें" में -ObjC जोड़ें. अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को बुनियादी से सभी पर सेट करें.

CocoaPods

iOS के लिए Places SDK टूल और iOS के लिए Places Swift SDK टूल (झलक), CocoaPod पॉड, GooglePlace, और GooglePlaceSwift के तौर पर उपलब्ध हैं.

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

sudo gem install cocoapods

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

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '9.2.0'
  pod 'GooglePlacesSwift', '0.3.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 की जगह अपनी एपीआई कुंजी डालें.

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

GooglePlacesSwift

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

  • इंपोर्ट स्टेटमेंट जोड़ें: 
    import GooglePlacesSwift
  • अपने application(_:didFinishLaunchingWithOptions:) तरीके में, YOUR_API_KEY को अपनी एपीआई कुंजी से बदलें: 
    PlacesClient.provideAPIKey("YOUR_API_KEY")

चौथा चरण (ज़रूरी नहीं): Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना

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

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

अगले चरण

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