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

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

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

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

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

  • आपके प्रोजेक्ट को प्लैटफ़ॉर्म के इन वर्शन या इसके बाद के वर्शन को टारगेट करना होगा:
    • iOS 13
    • macOS 10.15
    • टीवीओएस 13
    • WatchOS 7

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

  क्या आपको Cloud Messaging का इस्तेमाल करना है?

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

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

• Firebase में साइन इन करें 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 Cloud Messaging

   Firebase In-App Messaging Firebase Remote Config

   Remote Config को मनमुताबिक बनाना Firebase A/B Testing

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

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

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

Firebase आपके 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 Dynamic Links इसका इस्तेमाल करके उपयोगकर्ताओं को अपने App Store के पेज पर रीडायरेक्ट करें और Google Analytics तक इसमें कन्वर्ज़न इवेंट इंपोर्ट करें 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 और Authentication का इस्तेमाल करने के लिए:

   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 प्लैटफ़ॉर्म लाइब्रेरी के बारे में ज़्यादा जानकारी यहां दी गई है:

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

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

सेवा या प्रॉडक्ट	पॉड	SwiftPM लाइब्रेरी	Google Analytics.">Analytics जोड़ना चाहते हैं?
AdMob	pod 'Google-Mobile-Ads-SDK'	लागू नहीं
Analytics	pod 'FirebaseAnalytics'	FirebaseAnalytics
App Check	pod 'FirebaseAppCheck'	FirebaseAppCheck
App Distribution	pod 'FirebaseAppDistribution'	FirebaseAppDistribution
Authentication	pod 'FirebaseAuth'	FirebaseAuth
Cloud Firestore	pod 'FirebaseFirestore'	FirebaseFirestore
Cloud Functions for Firebase Client SDK	pod 'FirebaseFunctions'	FirebaseFunctions
Cloud Messaging	pod 'FirebaseMessaging'	FirebaseMessaging
Cloud Storage	pod 'FirebaseStorage'	FirebaseStorage
Crashlytics	pod 'FirebaseCrashlytics'	FirebaseCrashlytics
Dynamic Links	pod 'FirebaseDynamicLinks'	FirebaseDynamicLinks
In-App Messaging	pod 'FirebaseInAppMessaging'	FirebaseInAppMessaging	(ज़रूरी है)
Firebase इंस्टॉलेशन	pod 'FirebaseInstallations'	FirebaseInstallations
Firebase ML कस्टम मॉडल के एपीआई	pod 'FirebaseMLModelDownloader'	FirebaseMLModelDownloader
Performance Monitoring	pod 'FirebasePerformance'	FirebasePerformance
Realtime Database	pod 'FirebaseDatabase'	FirebaseDatabase
Remote Config	pod 'FirebaseRemoteConfig'	FirebaseRemoteConfig
Vertex AI in Firebase	लागू नहीं	FirebaseVertexAI-Preview

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

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

CocoaPods

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

फ़्रेमवर्क

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

1. फ़्रेमवर्क SDK टूल की ज़िप फ़ाइल डाउनलोड करें. यह ~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.

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

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

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

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

• इससे सूचनाएं भेजें Cloud Messaging.

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