अपने Apple प्रोजेक्ट में Firebase जोड़ना

ज़रूरी शर्तें

• इन्हें इंस्टॉल करें:

  • Xcode 14.1 या उसके बाद का वर्शन

• पक्का करें कि आपका प्रोजेक्ट इन ज़रूरी शर्तों को पूरा करता हो:

  • आपके प्रोजेक्ट को प्लैटफ़ॉर्म के इन वर्शन या इसके बाद के वर्शन को टारगेट करना होगा:
    • iOS 11
    • macOS 10.13 वर्शन
    • TVOS 12
    • WatchOS 6

• अपना ऐप्लिकेशन चलाने के लिए, Apple डिवाइस सेट अप करें या सिम्युलेटर का इस्तेमाल करें.

  क्या आपको क्लाउड से मैसेज करने हैं?

  Apple प्लैटफ़ॉर्म पर क्लाउड से मैसेज करने के लिए, ज़रूरी शर्तें यहां दी गई हैं:

  • फ़िज़िकल Apple डिवाइस सेट अप करें.
  • अपने Google Ads खाते के लिए, Apple पुश नोटिफ़िकेशन से पुष्टि करने वाली कुंजी पाएं Apple Developer account.
  • ऐप्लिकेशन > मिलने वाली अनुमतियां.

• अपने Google खाता.

अगर आपके पास पहले से Xcode प्रोजेक्ट नहीं है और आपको सिर्फ़ Firebase आज़माना है, तो प्रॉडक्ट के लिए, आप हमारे क्विकस्टार्ट सैंपल में से एक डाउनलोड कर सकते हैं.

पहला चरण: Firebase प्रोजेक्ट बनाना

Firebase को अपने Apple ऐप्लिकेशन में जोड़ने से पहले, आपको एक Firebase बनाना होगा आपके ऐप्लिकेशन से कनेक्ट करने के लिए प्रोजेक्ट भी होता है. इस लिंक पर जाएँ ज़्यादा जानने के लिए, Firebase प्रोजेक्ट को समझना Firebase प्रोजेक्ट.

Firebase प्रोजेक्ट बनाना

1. Firebase कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें.

   • किसी मौजूदा Google Cloud प्रोजेक्ट में Firebase के संसाधन जोड़ने के लिए, प्रोजेक्ट का नाम डालें या ड्रॉपडाउन मेन्यू से इसे चुनें.

   • नया प्रोजेक्ट बनाने के लिए, प्रोजेक्ट का पसंदीदा नाम डालें. यह विकल्प भी इस्तेमाल किया जा सकता है प्रोजेक्ट के नाम के नीचे दिखाए गए प्रोजेक्ट आईडी में बदलाव करें.

2. अगर कहा जाए, तो Firebase की शर्तों को पढ़ें और स्वीकार करें.

3. जारी रखें पर क्लिक करें.

4. (ज़रूरी नहीं) अपने प्रोजेक्ट के लिए Google Analytics सेट अप करना. इसकी मदद से, नीचे दिए गए Firebase प्रॉडक्ट में से किसी भी एक का इस्तेमाल करके बेहतर अनुभव पाने के लिए:

   Firebase Crashlytics Firebase क्लाउड से मैसेज

   Firebase इन-ऐप्लिकेशन मैसेज Firebase रिमोट कॉन्फ़िगरेशन

   रिमोट कॉन्फ़िगरेशन को उपयोगकर्ता के मनमुताबिक बनाना Firebase A/B टेस्टिंग

   मौजूदा रिपोर्ट में से किसी एक को चुनें Google Analytics खाता या नया खाता बनाने के लिए.

   अगर नया खाता बनाया जाता है, तो Analytics रिपोर्टिंग स्थान, फिर स्वीकार करें डेटा शेयर करने की सेटिंग और Google Analytics की शर्तों में बदलाव कर सकते हैं.

5. प्रोजेक्ट बनाएं पर क्लिक करें (या अगर आप किसी मौजूदा Google Cloud प्रोजेक्ट शामिल हैं).

Firebase आपके Firebase प्रोजेक्ट के लिए संसाधन अपने-आप सेट अप करता है. टास्क कब शुरू होगा प्रोसेस पूरी हो जाती है, तो आपको Firebase के खास जानकारी वाले पेज पर ले जाया जाएगा प्रोजेक्ट पर काम करता है.

दूसरा चरण: अपने ऐप्लिकेशन को Firebase के साथ रजिस्टर करना

Apple ऐप्लिकेशन में Firebase का इस्तेमाल करने के लिए, आपको अपने ऐप्लिकेशन को Firebase प्रोजेक्ट. अपने ऐप्लिकेशन को रजिस्टर करने को अक्सर "जोड़ना" कहा जाता है आपका ऐप्लिकेशन प्रोजेक्ट.

1. Firebase कंसोल पर जाएं.

2. प्रोजेक्ट की खास जानकारी देने वाले पेज के बीच में, iOS+ आइकॉन पर क्लिक करें सेटअप वर्कफ़्लो लॉन्च करने के लिए.

   अगर आपने पहले ही अपने Firebase प्रोजेक्ट में कोई ऐप्लिकेशन जोड़ लिया है, तो ऐप्लिकेशन जोड़ें पर क्लिक करें प्लैटफ़ॉर्म के विकल्प दिखाने के लिए.

3. बंडल आईडी फ़ील्ड में अपने ऐप्लिकेशन का बंडल आईडी डालें.

   बंडल आईडी क्या होता है और आपको यह कहां मिलता है?

   • बंडल आईडी खास तौर पर Apple के नेटवर्क में किसी ऐप्लिकेशन की पहचान करता है.

   • अपना बंडल आईडी ढूंढें: Xcode में अपना प्रोजेक्ट खोलें, फिर प्रोजेक्ट नेविगेटर में टॉप-लेवल ऐप्लिकेशन खोलें. इसके बाद, सामान्य टैब को चुनें.

     बंडल आइडेंटिफ़ायर फ़ील्ड की वैल्यू, बंडल आईडी होती है (उदाहरण के लिए, com.yourcompany.yourproject).

   • ध्यान रखें कि बंडल आईडी का मान केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होता है. यह ऐसा नहीं हो सकता इस Firebase ऐप्लिकेशन के पंजीकृत होने के बाद इसके लिए बदल दिया गया है Firebase प्रोजेक्ट.

4. (ज़रूरी नहीं) ऐप्लिकेशन के बारे में अन्य जानकारी डालें: ऐप्लिकेशन का कोई दूसरा नाम और App Store आईडी.

   ऐप्लिकेशन का कोई दूसरा नाम और क्या Firebase में App Store आईडी का इस्तेमाल किया जाता है?

   • ऐप्लिकेशन का कोई दूसरा नाम: एक ऐसा अंदरूनी और सुविधा आइडेंटिफ़ायर जो सिर्फ़ दिखता है आपके लिए Firebase कंसोल में

   • App Store आईडी: इसका इस्तेमाल Firebase डाइनैमिक लिंक उपयोगकर्ताओं को अपने App Store के पेज पर रीडायरेक्ट करें मदद मिलती है. कन्वर्ज़न इवेंट को यहां इंपोर्ट करें Google Ads का इस्तेमाल करें. अगर आपके ऐप्लिकेशन में अभी तक App Store आईडी नहीं है, तो बाद में आईडी जोड़ा जा सकता है प्रोजेक्ट में सेटिंग पर टैप करें.

5. ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.

तीसरा चरण: Firebase कॉन्फ़िगरेशन फ़ाइल जोड़ना

1. अपने Firebase Apple को पाने के लिए, GoogleService-Info.plist डाउनलोड करें पर क्लिक करें प्लैटफ़ॉर्म कॉन्फ़िगरेशन फ़ाइल (GoogleService-Info.plist).

   आपको इस कॉन्फ़िगरेशन फ़ाइल के बारे में क्या जानने की ज़रूरत है?

   • Firebase कॉन्फ़िगरेशन फ़ाइल में, यूनीक, लेकिन नॉन-सीक्रेट आइडेंटिफ़ायर हैं आपका प्रोजेक्ट. इस कॉन्फ़िगरेशन फ़ाइल के बारे में ज़्यादा जानने के लिए, यहां जाएं Firebase के बारे में जानकारी प्रोजेक्ट.

   • Firebase का कॉन्फ़िगरेशन डाउनलोड किया जा सकता है फ़ाइल किसी भी समय फिर से भेजा जा सकता है.

   • पक्का करें कि कॉन्फ़िगरेशन फ़ाइल के नाम में अतिरिक्त वर्ण न हों, (2) पसंद है.

2. अपनी कॉन्फ़िगरेशन फ़ाइल को Xcode प्रोजेक्ट के रूट में ले जाएं. पूछे जाने पर, सभी टारगेट में कॉन्फ़िगरेशन फ़ाइल जोड़ने के लिए, इसे चुनें.

अगर आपके प्रोजेक्ट में एक से ज़्यादा बंडल आईडी हैं, तो आपको हर बंडल को जोड़ना होगा Firebase कंसोल में रजिस्टर किए गए ऐप्लिकेशन के साथ आईडी, ताकि हर ऐप्लिकेशन के लिए उसकी अपनी GoogleService-Info.plist फ़ाइल है.

चौथा चरण: अपने ऐप्लिकेशन में Firebase SDK टूल जोड़ना

Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift पैकेज मैनेजर का इस्तेमाल करें.

1. Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलने के लिए, फ़ाइल > पैकेज जोड़ना.
2. जब कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल का रिपॉज़िटरी जोड़ें:

  https://github.com/firebase/firebase-ios-sdk

3. SDK टूल का वह वर्शन चुनें जिसका आपको इस्तेमाल करना है.

4. वे Firebase लाइब्रेरी चुनें जिनका आपको इस्तेमाल करना है.

   अगर आपके Firebase प्रोजेक्ट में Google Analytics चालू है, तो पक्का करें कि FirebaseAnalytics जोड़ने के लिए. बिना IDFA कलेक्शन वाले Analytics के लिए का इस्तेमाल करने के लिए, इसके बजाय FirebaseAnalyticsWithoutAdId जोड़ें.

यह काम पूरा होने पर, Xcode अपने-आप रिज़ॉल्व और डाउनलोड होना शुरू कर देगा पर निर्भर करता है.

पांचवां चरण: अपने ऐप्लिकेशन में Firebase शुरू करना

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

1. अपने इसमें FirebaseCore मॉड्यूल को इंपोर्ट करें UIApplicationDelegate और अन्य वे Firebase मॉड्यूल जिनका इस्तेमाल आपका ऐप्लिकेशन मैनेज करने का ऐक्सेस देने वाला व्यक्ति करता है. उदाहरण के लिए, Cloud Firestore और पुष्टि करने की सुविधा का इस्तेमाल करने के लिए:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. कॉन्फ़िगर करें FirebaseApp आपके ऐप्लिकेशन डेलिगेट के शेयर किए गए इंस्टेंस में application(_:didFinishLaunchingWithOptions:) तरीका:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. अगर SwiftUI का इस्तेमाल किया जा रहा है, तो आपको ऐप्लिकेशन का ऐक्सेस देना होगा और उसे अटैच करना होगा UIApplicationDelegateAdaptor के ज़रिए अपने App निर्देश को या NSApplicationDelegateAdaptor. आपको ऐप्लिकेशन सौंपने की सुविधा को स्वाइप करने की सुविधा भी बंद करनी होगी. इसके लिए ज़्यादा जानकारी के लिए, SwiftUI के निर्देश देखें.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. अगर आपने Google Analytics के लिए Firebase SDK टूल को शामिल किया है, तो आपका ऐप्लिकेशन, उस Firebase कंसोल को पुष्टि करने के लिए भेज सके जिसे आपने Firebase इंस्टॉल हो गया.

बस हो गया! आप सीधे अगले चरणों पर जा सकते हैं.

अगर आपको सेट अप करने में समस्या आ रही है, तो इस लिंक पर जाएं Apple प्लैटफ़ॉर्म की समस्याएं हल करना और अक्सर पूछे जाने वाले सवाल.

उपलब्ध लाइब्रेरी

इस सेक्शन में Apple प्लैटफ़ॉर्म के लिए काम करने वाले Firebase प्रॉडक्ट की सूची दी गई है. ज़्यादा जानें इन Firebase Apple प्लैटफ़ॉर्म लाइब्रेरी के बारे में ज़्यादा जानकारी यहां दी गई है:

• रेफ़रंस के लिए दस्तावेज़ (स्विफ़्ट | ओबीजे-सी)

• Firebase Apple प्लैटफ़ॉर्म SDK टूल GitHub रेपो

सेवा या प्रॉडक्ट	पॉड	SwiftPM लाइब्रेरी	क्या आपको Analytics जोड़ना है?
AdMob	pod 'Google-Mobile-Ads-SDK'	लागू नहीं
Analytics	pod 'FirebaseAnalytics'	FirebaseAnalytics
ऐप्लिकेशन की जांच	pod 'FirebaseAppCheck'	FirebaseAppCheck
ऐप्लिकेशन डिस्ट्रिब्यूशन	pod 'FirebaseAppDistribution'	FirebaseAppDistribution
पुष्टि करना	pod 'FirebaseAuth'	FirebaseAuth
Cloud Firestore	pod 'FirebaseFirestore'	FirebaseFirestore
Cloud Functions for Firebase क्लाइंट SDK टूल	pod 'FirebaseFunctions'	FirebaseFunctions
क्लाउड से मैसेज	pod 'FirebaseMessaging'	FirebaseMessaging
क्लाउड स्टोरेज	pod 'FirebaseStorage'	FirebaseStorage
Crashlytics	pod 'FirebaseCrashlytics'	FirebaseCrashlytics
डाइनैमिक लिंक	pod 'FirebaseDynamicLinks'	FirebaseDynamicLinks
इन-ऐप्लिकेशन मैसेज	pod 'FirebaseInAppMessaging'	FirebaseInAppMessaging	(ज़रूरी है)
Firebase इंस्टॉल करना	pod 'FirebaseInstallations'	FirebaseInstallations
Firebase एमएल कस्टम मॉडल एपीआई	pod 'FirebaseMLModelDownloader'	FirebaseMLModelDownloader
परफ़ॉर्मेंस मॉनिटर करना	pod 'FirebasePerformance'	FirebasePerformance
रीयलटाइम डेटाबेस	pod 'FirebaseDatabase'	FirebaseDatabase
रिमोट कॉन्फ़िगरेशन	pod 'FirebaseRemoteConfig'	FirebaseRemoteConfig
Firebase के लिए Vertex AI	लागू नहीं	FirebaseVertexAI-Preview

Swift पैकेज मैनेजर का इस्तेमाल किए बिना इंटिग्रेट करें

अगर आपको Swift Package Manager का इस्तेमाल नहीं करना है, तब भी इस सुविधा का फ़ायदा लिया जा सकता है Firebase SDK टूल का इस्तेमाल करने के लिए, CocoaPods का इस्तेमाल करें या सीधे फ़्रेमवर्क इंपोर्ट करें.

CocoaPods

इसमें CocoaPods इंटिग्रेशन के बारे में ज़्यादा जानें हमारी गाइड देखें.

फ़्रेमवर्क

iOS प्लैटफ़ॉर्म पर काम करने के साथ-साथ, अब ZIP में .xcframework भी शामिल है फ़ाइलें. जानकारी के लिए, Firebase देखें Apple प्लैटफ़ॉर्म SDK टूल README चालू है GitHub को अपनाएं.

1. फ़्रेमवर्क SDK टूल की ZIP फ़ाइल डाउनलोड करें. यह ~200 एमबी की फ़ाइल है और इसमें डाउनलोड करने में थोड़ा समय लगता है.

2. फ़ाइल को अनज़िप करें. इसके बाद, उन फ़्रेमवर्क को इंटिग्रेट करें जिन्हें आपको शामिल करना है आपके ऐप्लिकेशन में.

   इंटिग्रेशन के निर्देश, इनमें से किसी एक जगह पर मिल सकते हैं:

   • इस Firebase iOS SDK GitHub रिपॉज़िटरी.
   • डाउनलोड किए गए ZIP डिस्ट्रिब्यूशन में README.md फ़ाइल में.

   फ़्रेमवर्क वर्शन या डिपेंडेंसी के बारे में जानकारी के लिए, यहां जाएं: METADATA.md फ़ाइल डाउनलोड की गई ज़िप डिस्ट्रिब्यूशन में.

3. जोड़ें -ObjC लिंकर फ़्लैग अपने टारगेट की बिल्ड सेटिंग के Other Linker Settings में.

अगले चरण

Firebase के बारे में जानें:

• ज़्यादा जानने के लिए, Firebase प्रोजेक्ट को समझना पर जाएं इनमें Firebase प्रोजेक्ट और उनसे जुड़े सबसे सही तरीकों के बारे में जानकारी दी गई है.

• Firebase ऐप्लिकेशन के सैंपल एक्सप्लोर करें.

• Firebase iOS के साथ व्यावहारिक अनुभव पाएं कोडलैब (कोड बनाना सीखना).

• एक्सप्लोर करें GitHub में ओपन सोर्स कोड.

• अपना ऐप्लिकेशन लॉन्च करने की तैयारी करें:

  • बजट सेट अप करें सूचनाएं Google Cloud कंसोल में अपने प्रोजेक्ट के लिए.
  • इस्तेमाल और बिलिंग पर नज़र रखें डैशबोर्ड देखने के लिए Firebase कंसोल का इस्तेमाल करें. Firebase की अलग-अलग सेवाओं के लिए इस्तेमाल किया जा सकता है.
  • Firebase के लॉन्च की चेकलिस्ट देखें.

• क्या आपको Firebase और Apple प्रोजेक्ट में कोई समस्या आ रही है? Apple प्लैटफ़ॉर्म से जुड़ी समस्याओं को हल करने के तरीके और अक्सर पूछे जाने वाले सवाल.

अपने ऐप्लिकेशन में Firebase की सेवाएं जोड़ें:

• की मदद से उपयोगकर्ता के व्यवहार के बारे में इनसाइट पाएं Analytics.

• पुष्टि करने की सुविधा का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने की सुविधा सेट अप करें.

• उपयोगकर्ता की जानकारी जैसे डेटा को इनके साथ सेव करता है Cloud Firestore या रीयलटाइम डेटाबेस.

• फ़ोटो और वीडियो जैसी फ़ाइलें सेव करने के लिए, Cloud Storage.

• बैकएंड कोड को ट्रिगर करें, जो इसके साथ सुरक्षित एनवायरमेंट में चलता है Cloud के फ़ंक्शन.

• इससे सूचनाएं भेजें क्लाउड से मैसेज.

• पता लगाएं कि आपका ऐप्लिकेशन, कब और क्यों क्रैश हो रहा है Crashlytics.