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

आवश्यक शर्तें

• निम्नलिखित स्थापित करें:

  • एक्सकोड 13.3.1 या बाद में

• सुनिश्चित करें कि आपकी परियोजना इन आवश्यकताओं को पूरा करती है:

  • आपकी परियोजना को इन प्लेटफ़ॉर्म संस्करणों या बाद के संस्करणों को लक्षित करना चाहिए:
    • आईओएस 11
    • मैकोज़ 10.13
    • टीवीओएस 12
    • वॉचओएस 6

• एक भौतिक Apple डिवाइस सेट करें या अपना ऐप चलाने के लिए एक सिम्युलेटर का उपयोग करें।

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

  Apple प्लेटफ़ॉर्म पर क्लाउड मैसेजिंग के लिए, यहाँ पूर्वापेक्षाएँ हैं:

  • एक भौतिक Apple डिवाइस सेट करें।
  • अपने Apple डेवलपर खाते के लिए Apple Push Notification Authentication Key प्राप्त करें।
  • ऐप> क्षमताओं के तहत एक्सकोड में पुश अधिसूचनाएं सक्षम करें।

• अपने Google खाते का उपयोग करके फायरबेस में साइन इन करें ।

यदि आपके पास पहले से कोई Xcode प्रोजेक्ट नहीं है और आप केवल एक Firebase उत्पाद आज़माना चाहते हैं, तो आप हमारे क्विकस्टार्ट नमूनों में से एक को डाउनलोड कर सकते हैं।

चरण 1 : एक फायरबेस प्रोजेक्ट बनाएं

इससे पहले कि आप अपने Apple ऐप में Firebase जोड़ सकें, आपको अपने ऐप से कनेक्ट करने के लिए एक Firebase प्रोजेक्ट बनाना होगा। फायरबेस प्रोजेक्ट्स के बारे में अधिक जानने के लिए अंडरस्टैंड फायरबेस प्रोजेक्ट्स पर जाएं।

एक फायरबेस प्रोजेक्ट बनाएं

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

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

   • एक नया प्रोजेक्ट बनाने के लिए, वांछित प्रोजेक्ट का नाम दर्ज करें। आप प्रोजेक्ट नाम के नीचे प्रदर्शित प्रोजेक्ट आईडी को वैकल्पिक रूप से संपादित भी कर सकते हैं।

2. संकेत मिलने पर, Firebase शर्तों की समीक्षा करें और उन्हें स्वीकार करें.

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

4. (वैकल्पिक) अपने प्रोजेक्ट के लिए Google Analytics सेट अप करें, जो आपको निम्न में से किसी भी Firebase उत्पाद का उपयोग करने का एक इष्टतम अनुभव प्रदान करने में सक्षम बनाता है:

   फायरबेस क्रैशलिटिक्स फायरबेस क्लाउड मैसेजिंग

   फायरबेस इन-ऐप मैसेजिंग फायरबेस रिमोट कॉन्फिग

   रिमोट कॉन्फिग वैयक्तिकरण फायरबेस ए / बी परीक्षण

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

   यदि आप एक नया खाता बनाते हैं, तो अपना Analytics रिपोर्टिंग स्थान चुनें, फिर अपने प्रोजेक्ट के लिए डेटा साझाकरण सेटिंग और Google Analytics शर्तें स्वीकार करें।

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

फायरबेस स्वचालित रूप से आपके फायरबेस प्रोजेक्ट के लिए संसाधनों का प्रावधान करता है। जब प्रक्रिया पूरी हो जाती है, तो आपको Firebase कंसोल में आपके Firebase प्रोजेक्ट के अवलोकन पृष्ठ पर ले जाया जाएगा।

चरण 2 : अपने ऐप को फायरबेस के साथ पंजीकृत करें

अपने Apple ऐप में Firebase का उपयोग करने के लिए, आपको अपने ऐप को अपने Firebase प्रोजेक्ट के साथ पंजीकृत करना होगा। अपने ऐप को पंजीकृत करने को अक्सर आपके ऐप को आपके प्रोजेक्ट में "जोड़ना" कहा जाता है।

1. फायरबेस कंसोल पर जाएं।

2. प्रोजेक्ट अवलोकन पृष्ठ के केंद्र में, सेटअप वर्कफ़्लो लॉन्च करने के लिए iOS+ आइकन पर क्लिक करें।

   यदि आप पहले से ही अपने फायरबेस प्रोजेक्ट में एक ऐप जोड़ चुके हैं, तो प्लेटफ़ॉर्म विकल्प प्रदर्शित करने के लिए ऐप जोड़ें पर क्लिक करें।

3. बंडल आईडी फ़ील्ड में अपने ऐप की बंडल आईडी दर्ज करें।

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

   • एक बंडल आईडी विशिष्ट रूप से Apple के पारिस्थितिकी तंत्र में एक एप्लिकेशन की पहचान करता है।

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

     बंडल पहचानकर्ता फ़ील्ड का मान बंडल आईडी है (उदाहरण के लिए, com.yourcompany.yourproject )।

   • ध्यान रखें कि बंडल आईडी मान केस-संवेदी है, और इसे आपके फायरबेस प्रोजेक्ट के साथ पंजीकृत होने के बाद इस फायरबेस ऐप के लिए नहीं बदला जा सकता है।

4. (वैकल्पिक) अन्य ऐप जानकारी दर्ज करें: ऐप उपनाम और ऐप स्टोर आईडी ।

   ऐप उपनाम और ऐप स्टोर आईडी का उपयोग फायरबेस के भीतर कैसे किया जाता है?

   • ऐप का उपनाम : एक आंतरिक, सुविधा पहचानकर्ता जो केवल फायरबेस कंसोल में आपको दिखाई देता है

   • ऐप स्टोर आईडी : फायरबेस डायनेमिक लिंक द्वारा उपयोगकर्ताओं को आपके ऐप स्टोर पेज पर रीडायरेक्ट करने के लिए और Google एनालिटिक्स द्वारा Google विज्ञापनों में रूपांतरण घटनाओं को आयात करने के लिए उपयोग किया जाता है। यदि आपके ऐप में अभी तक ऐप स्टोर आईडी नहीं है, तो आप बाद में अपनी प्रोजेक्ट सेटिंग में आईडी जोड़ सकते हैं।

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

चरण 3 : एक Firebase कॉन्फ़िगरेशन फ़ाइल जोड़ें

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

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

   • फायरबेस कॉन्फ़िगरेशन फ़ाइल में आपके प्रोजेक्ट के लिए अद्वितीय, लेकिन गैर-गुप्त पहचानकर्ता शामिल हैं। इस कॉन्फ़िगरेशन फ़ाइल के बारे में अधिक जानने के लिए, Firebase Projects को समझें पर जाएं।

   • आप किसी भी समय अपनी फायरबेस कॉन्फ़िगरेशन फ़ाइल को दोबारा डाउनलोड कर सकते हैं।

   • सुनिश्चित करें कि कॉन्फ़िगरेशन फ़ाइल नाम अतिरिक्त वर्णों के साथ नहीं जोड़ा गया है, जैसे (2) .

2. अपनी कॉन्फ़िगरेशन फ़ाइल को अपने एक्सकोड प्रोजेक्ट की जड़ में ले जाएं। यदि संकेत दिया जाता है, तो सभी लक्ष्यों में कॉन्फ़िग फ़ाइल जोड़ने के लिए चयन करें।

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

चरण 4 : अपने ऐप में फायरबेस एसडीके जोड़ें

फायरबेस निर्भरताओं को स्थापित और प्रबंधित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।

1. Xcode में, अपने ऐप प्रोजेक्ट को खोलने के साथ, File > Add Packages पर नेविगेट करें।
2. संकेत दिए जाने पर, Firebase Apple प्लेटफ़ॉर्म SDK रिपॉजिटरी जोड़ें:

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

3. एसडीके संस्करण का चयन करें जिसका आप उपयोग करना चाहते हैं।

4. वह फायरबेस लाइब्रेरी चुनें जिसका आप उपयोग करना चाहते हैं।

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

समाप्त होने पर, Xcode स्वचालित रूप से पृष्ठभूमि में आपकी निर्भरताओं को हल करना और डाउनलोड करना शुरू कर देगा।

चरण 5 : अपने ऐप में फायरबेस को इनिशियलाइज़ करें

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

1. अपने UIApplicationDelegate में FirebaseCore मॉड्यूल आयात करें, साथ ही आपके ऐप प्रतिनिधि द्वारा उपयोग किए जाने वाले किसी भी अन्य Firebase मॉड्यूल को आयात करें। उदाहरण के लिए, क्लाउड फायरस्टार और प्रमाणीकरण का उपयोग करने के लिए:

   स्विफ्टयूआई

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

   तीव्र

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   उद्देश्य सी

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

2. अपने ऐप प्रतिनिधि के application(_:didFinishLaunchingWithOptions:) विधि में FirebaseApp साझा उदाहरण कॉन्फ़िगर करें:

   स्विफ्टयूआई

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

   तीव्र

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

   उद्देश्य सी

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

3. यदि आप SwiftUI का उपयोग कर रहे हैं, तो आपको एक एप्लिकेशन प्रतिनिधि बनाना होगा और इसे UIApplicationDelegateAdaptor या NSApplicationDelegateAdaptor के माध्यम से अपने App स्ट्रक्चर में संलग्न करना होगा। आपको ऐप डेलिगेट स्विज़लिंग को भी अक्षम करना होगा। अधिक जानकारी के लिए, 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 प्लेटफ़ॉर्म समस्या निवारण और FAQ पर जाएँ।

उपलब्ध पुस्तकालय

यह अनुभाग Apple प्लेटफ़ॉर्म के लिए समर्थित Firebase उत्पादों की सूची देता है। इन Firebase Apple प्लेटफ़ॉर्म लाइब्रेरी के बारे में और जानें:

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

• फायरबेस ऐप्पल प्लेटफॉर्म एसडीके गिटहब रेपो

सेवा या उत्पाद	फली	स्विफ्टपीएम लाइब्रेरी	विश्लेषिकी जोड़ें?
AdMob	pod 'Google-Mobile-Ads-SDK'	लागू नहीं
एनालिटिक्स	pod 'FirebaseAnalytics'	FirebaseAnalytics
ऐप चेक	pod 'FirebaseAppCheck'	FirebaseAppCheck
ऐप वितरण	pod 'FirebaseAppDistribution'	FirebaseAppDistribution
प्रमाणीकरण	pod 'FirebaseAuth'	FirebaseAuth
क्लाउड फायरस्टोर	pod 'FirebaseFirestore'	FirebaseFirestore
फायरबेस क्लाइंट एसडीके के लिए क्लाउड फ़ंक्शंस	pod 'FirebaseFunctions'	FirebaseFunctions
क्लाउड मैसेजिंग	pod 'FirebaseMessaging'	FirebaseMessaging
घन संग्रहण	pod 'FirebaseStorage'	FirebaseStorage
Crashlytics	pod 'FirebaseCrashlytics'	FirebaseCrashlytics
गतिशील लिंक	pod 'FirebaseDynamicLinks'	FirebaseDynamicLinks
इन-ऐप मैसेजिंग	pod 'FirebaseInAppMessaging'	FirebaseInAppMessaging	(आवश्यक)
फायरबेस प्रतिष्ठान	pod 'FirebaseInstallations'	FirebaseInstallations
फायरबेस एमएल कस्टम मॉडल एपीआई	pod 'FirebaseMLModelDownloader'	FirebaseMLModelDownloader
निष्पादन की निगरानी	pod 'FirebasePerformance'	FirebasePerformance
रीयलटाइम डेटाबेस	pod 'FirebaseDatabase'	FirebaseDatabase
दूरस्थ विन्यास	pod 'FirebaseRemoteConfig'	FirebaseRemoteConfig

स्विफ्ट पैकेज मैनेजर का उपयोग किए बिना एकीकृत करें

यदि आप स्विफ्ट पैकेज मैनेजर का उपयोग नहीं करना चाहते हैं, तब भी आप CocoaPods का उपयोग करके या सीधे फ्रेमवर्क आयात करके फायरबेस एसडीके का लाभ उठा सकते हैं।

कोकोपोड्स

हमारे गाइड में CocoaPods एकीकरण के बारे में और जानें।

फ़्रेमवर्क

iOS प्लैटफ़ॉर्म को सपोर्ट करने के अलावा, zip में अब .xcframework फ़ाइलें भी शामिल हैं। विवरण के लिए, GitHub पर Firebase Apple प्लेटफ़ॉर्म SDK README देखें।

1. फ्रेमवर्क एसडीके जिप डाउनलोड करें। यह एक ~200MB फ़ाइल है और इसे डाउनलोड होने में कुछ समय लग सकता है।

2. फ़ाइल को अनज़िप करें, और फिर उन रूपरेखाओं को एकीकृत करें जिन्हें आप अपने ऐप में शामिल करना चाहते हैं।

   आप निम्न में से किसी भी स्थान पर एकीकरण निर्देश प्राप्त कर सकते हैं:

   • फायरबेस आईओएस एसडीके गिटहब रिपॉजिटरी में।
   • डाउनलोड किए गए ज़िप वितरण के भीतर README.md फ़ाइल में।

   फ्रेमवर्क संस्करण या निर्भरताओं के बारे में जानकारी के लिए, डाउनलोड किए गए ज़िप वितरण के भीतर METADATA.md फ़ाइल देखें।

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

अगले कदम

फायरबेस के बारे में जानें:

• फायरबेस परियोजनाओं और परियोजनाओं के सर्वोत्तम अभ्यासों के बारे में अधिक जानने के लिए फायरबेस परियोजनाओं को समझें पर जाएं।

• नमूना Firebase ऐप्स एक्सप्लोर करें।

• Firebase iOS कोडलैब के साथ व्यवहारिक अनुभव प्राप्त करें।

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

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

  • Google क्लाउड कंसोल में अपने प्रोजेक्ट के लिए बजट अलर्ट सेट अप करें।
  • कई फायरबेस सेवाओं में अपने प्रोजेक्ट के उपयोग की समग्र तस्वीर प्राप्त करने के लिए फायरबेस कंसोल में उपयोग और बिलिंग डैशबोर्ड की निगरानी करें।
  • फायरबेस लॉन्च चेकलिस्ट की समीक्षा करें।

• Firebase और अपने Apple प्रोजेक्ट से परेशानी हो रही है? समस्या निवारण और अक्सर पूछे जाने वाले प्रश्न Apple प्लेटफ़ॉर्म पर जाएँ।

अपने ऐप में फायरबेस सेवाएं जोड़ें:

• एनालिटिक्स के साथ उपयोगकर्ता व्यवहार पर अंतर्दृष्टि प्राप्त करें।

• प्रमाणीकरण के साथ उपयोगकर्ता प्रमाणीकरण सेट करें।

• Cloud Firestore या Realtime Database के साथ डेटा स्टोर करें, जैसे उपयोगकर्ता की जानकारी।

• क्लाउड स्टोरेज के साथ, फ़ोटो और वीडियो जैसी फ़ाइलें स्टोर करें।

• ट्रिगर बैकएंड कोड जो क्लाउड फ़ंक्शंस के साथ सुरक्षित वातावरण में चलता है।

• क्लाउड मैसेजिंग के साथ सूचनाएं भेजें।

• पता करें कि कब और क्यों आपका ऐप Crashlytics से क्रैश हो रहा है।