आवश्यक शर्तें
निम्नलिखित स्थापित करें:
- एक्सकोड 13.3.1 या बाद में
सुनिश्चित करें कि आपकी परियोजना इन आवश्यकताओं को पूरा करती है:
- आपके प्रोजेक्ट को इन प्लेटफ़ॉर्म संस्करणों या बाद के संस्करणों को लक्षित करना चाहिए:
- आईओएस 10
- मैकोज़ 10.12
- टीवीओएस 12
- वॉचओएस 6
- आपके प्रोजेक्ट को इन प्लेटफ़ॉर्म संस्करणों या बाद के संस्करणों को लक्षित करना चाहिए:
एक भौतिक Apple डिवाइस सेट करें या अपना ऐप चलाने के लिए सिम्युलेटर का उपयोग करें।
Apple प्लेटफॉर्म पर क्लाउड मैसेजिंग के लिए, यहां पूर्वापेक्षाएँ दी गई हैं:
- एक भौतिक Apple डिवाइस सेट करें।
- अपने Apple डेवलपर खाते के लिए Apple पुश सूचना प्रमाणीकरण कुंजी प्राप्त करें।
- ऐप> क्षमताओं के तहत एक्सकोड में पुश नोटिफिकेशन सक्षम करें।
- अपने Google खाते का उपयोग करके Firebase में साइन इन करें ।
यदि आपके पास पहले से कोई Xcode प्रोजेक्ट नहीं है और आप केवल Firebase उत्पाद आज़माना चाहते हैं, तो आप हमारे त्वरित प्रारंभ नमूनों में से एक को डाउनलोड कर सकते हैं।
चरण 1 : एक फायरबेस प्रोजेक्ट बनाएं
इससे पहले कि आप अपने ऐप्पल ऐप में फायरबेस जोड़ सकें, आपको अपने ऐप से कनेक्ट करने के लिए एक फायरबेस प्रोजेक्ट बनाना होगा। फायरबेस प्रोजेक्ट्स के बारे में अधिक जानने के लिए फायरबेस प्रोजेक्ट्स को समझें पर जाएं।
चरण 2 : अपने ऐप को Firebase के साथ पंजीकृत करें
अपने ऐप्पल ऐप में फायरबेस का उपयोग करने के लिए, आपको अपने ऐप को अपने फायरबेस प्रोजेक्ट के साथ पंजीकृत करना होगा। अपने ऐप को पंजीकृत करने को अक्सर अपने प्रोजेक्ट में अपने ऐप को "जोड़ना" कहा जाता है।
फायरबेस कंसोल पर जाएं।
प्रोजेक्ट ओवरव्यू पेज के केंद्र में, सेटअप वर्कफ़्लो लॉन्च करने के लिए iOS+ आइकन पर क्लिक करें।
अगर आपने पहले ही अपने फायरबेस प्रोजेक्ट में एक ऐप जोड़ लिया है, तो प्लेटफ़ॉर्म विकल्प प्रदर्शित करने के लिए ऐप जोड़ें पर क्लिक करें।
बंडल आईडी फ़ील्ड में अपने ऐप्लिकेशन की बंडल आईडी डालें.
एक बंडल आईडी विशिष्ट रूप से Apple के पारिस्थितिकी तंत्र में एक एप्लिकेशन की पहचान करता है।
अपनी बंडल आईडी खोजें: अपना प्रोजेक्ट Xcode में खोलें, प्रोजेक्ट नेविगेटर में शीर्ष-स्तरीय ऐप चुनें, फिर सामान्य टैब चुनें।
बंडल पहचानकर्ता फ़ील्ड का मान बंडल आईडी है (उदाहरण के लिए,
com.yourcompany.yourproject
)।ध्यान रखें कि बंडल आईडी मान केस-संवेदी है, और आपके Firebase प्रोजेक्ट के साथ पंजीकृत होने के बाद इसे इस Firebase ऐप के लिए बदला नहीं जा सकता है।
(वैकल्पिक) अन्य ऐप जानकारी दर्ज करें: ऐप उपनाम और ऐप स्टोर आईडी ।
ऐप का प्रचलित नाम : एक आंतरिक, सुविधा पहचानकर्ता जो केवल आपको Firebase कंसोल में दिखाई देता है
ऐप स्टोर आईडी : उपयोगकर्ताओं को आपके ऐप स्टोर पेज पर रीडायरेक्ट करने के लिए फायरबेस डायनेमिक लिंक द्वारा और Google Analytics द्वारा Google Ads में रूपांतरण ईवेंट आयात करने के लिए उपयोग किया जाता है। अगर आपके ऐप में अभी तक ऐप स्टोर आईडी नहीं है, तो आप बाद में अपनी प्रोजेक्ट सेटिंग में आईडी जोड़ सकते हैं।
रजिस्टर ऐप पर क्लिक करें।
चरण 3 : एक फायरबेस कॉन्फ़िगरेशन फ़ाइल जोड़ें
अपनी फ़ायरबेस ऐप्पल प्लेटफ़ॉर्म कॉन्फ़िग फ़ाइल (
GoogleService-Info.plist
) प्राप्त करने के लिए GoogleService-Info.plist डाउनलोड करें पर क्लिक करें।फायरबेस कॉन्फ़िगरेशन फ़ाइल में आपके प्रोजेक्ट के लिए अद्वितीय, लेकिन गैर-गुप्त पहचानकर्ता हैं। इस कॉन्फ़िग फ़ाइल के बारे में अधिक जानने के लिए, फायरबेस प्रोजेक्ट्स को समझें पर जाएं।
आप अपनी Firebase कॉन्फ़िग फ़ाइल को किसी भी समय फिर से डाउनलोड कर सकते हैं।
सुनिश्चित करें कि कॉन्फ़िगरेशन फ़ाइल नाम अतिरिक्त वर्णों के साथ नहीं जोड़ा गया है, जैसे
(2)
।
अपनी कॉन्फ़िगरेशन फ़ाइल को अपने एक्सकोड प्रोजेक्ट की जड़ में ले जाएं। संकेत मिलने पर, कॉन्फ़िग फ़ाइल को सभी लक्ष्यों में जोड़ने के लिए चुनें.
अगर आपके प्रोजेक्ट में कई बंडल आईडी हैं, तो आपको प्रत्येक बंडल आईडी को Firebase कंसोल में एक पंजीकृत ऐप से संबद्ध करना होगा ताकि प्रत्येक ऐप की अपनी GoogleService-Info.plist
फ़ाइल हो सके।
चरण 4 : अपने ऐप्लिकेशन में Firebase SDK टूल जोड़ें
फायरबेस निर्भरता को स्थापित और प्रबंधित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।
- Xcode में, आपका ऐप प्रोजेक्ट खुला होने के साथ, File > Add Packages पर नेविगेट करें।
- संकेत मिलने पर, Firebase Apple प्लेटफॉर्म्स SDK रिपॉजिटरी जोड़ें:
- उस SDK संस्करण का चयन करें जिसका आप उपयोग करना चाहते हैं।
वे Firebase लाइब्रेरी चुनें जिनका आप उपयोग करना चाहते हैं.
यदि आपके Firebase प्रोजेक्ट में Google Analytics सक्षम है, तो
FirebaseAnalytics
जोड़ना सुनिश्चित करें। बिना IDFA संग्रहण क्षमता वाले Analytics के लिए, इसके बजायFirebaseAnalyticsWithoutAdId
जोड़ें.
https://github.com/firebase/firebase-ios-sdk
समाप्त होने पर, Xcode स्वचालित रूप से पृष्ठभूमि में आपकी निर्भरता को हल करना और डाउनलोड करना शुरू कर देगा।
चरण 5 : अपने ऐप में फायरबेस को इनिशियलाइज़ करें
अंतिम चरण अपने आवेदन में इनिशियलाइज़ेशन कोड जोड़ना है। हो सकता है कि आपने अपने ऐप में फायरबेस जोड़ने के हिस्से के रूप में ऐसा पहले ही कर लिया हो। यदि आप क्विकस्टार्ट नमूना प्रोजेक्ट का उपयोग कर रहे हैं, तो यह आपके लिए किया गया है।
- अपने
UIApplicationDelegate
मेंFirebaseCore
मॉड्यूल आयात करें, साथ ही आपके ऐप प्रतिनिधि द्वारा उपयोग किए जाने वाले किसी भी अन्य Firebase मॉड्यूल को आयात करें। उदाहरण के लिए, क्लाउड फायरस्टोर और प्रमाणीकरण का उपयोग करने के लिए:तीव्र
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
उद्देश्य सी
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
-
FirebaseApp
साझा इंस्टेंस कॉन्फ़िगर करें, आमतौर पर आपकेApp
के प्रारंभकर्ता या ऐप प्रतिनिधि केapplication(_:didFinishLaunchingWithOptions:)
विधि में:तीव्र
// Use Firebase library to configure APIs FirebaseApp.configure()
उद्देश्य सी
// Use Firebase library to configure APIs [FIRApp configure];
- अगर आपने Google Analytics के लिए Firebase SDK शामिल किया है, तो आप Firebase कंसोल को सत्यापन भेजने के लिए अपना ऐप्लिकेशन चला सकते हैं कि आपने Firebase को सफलतापूर्वक इंस्टॉल कर लिया है।
इतना ही! आप अगले चरणों पर आगे बढ़ सकते हैं।
यदि आपको सेट अप करने में समस्या हो रही है, हालांकि, Apple प्लेटफ़ॉर्म समस्या निवारण और अक्सर पूछे जाने वाले प्रश्न पर जाएँ।
उपलब्ध पुस्तकालय
यह खंड 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 | |
क्रैशलिटिक्स | 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 एकीकरण के बारे में और जानें।
फ़्रेमवर्क
आईओएस प्लेटफॉर्म का समर्थन करने के अलावा, ज़िप में अब .xcframework
फ़ाइलें शामिल हैं। विवरण के लिए, GitHub पर Firebase Apple प्लेटफॉर्म SDK README देखें ।
फ्रेमवर्क एसडीके ज़िप डाउनलोड करें। यह एक ~200MB फ़ाइल है और इसे डाउनलोड होने में कुछ समय लग सकता है।
फ़ाइल को अनज़िप करें, फिर उन फ़्रेमवर्क के लिए
README
की समीक्षा करें जिन्हें आप अपने ऐप में शामिल करना चाहते हैं।अपने लक्ष्य की बिल्ड सेटिंग्स में अपनी
Other Linker Settings
में-ObjC
लिंकर ध्वज जोड़ें।
अगले कदम
फायरबेस के बारे में जानें:
फायरबेस प्रोजेक्ट्स और प्रोजेक्ट्स के लिए सर्वोत्तम प्रक्रियाओं के बारे में अधिक जानने के लिए फायरबेस प्रोजेक्ट्स को समझें पर जाएं।
नमूना Firebase ऐप्लिकेशन एक्सप्लोर करें.
फायरबेस आईओएस कोडलैब के साथ व्यावहारिक अनुभव प्राप्त करें।
GitHub में ओपन सोर्स कोड एक्सप्लोर करें।
अपना ऐप लॉन्च करने की तैयारी करें:
- Google क्लाउड कंसोल में अपने प्रोजेक्ट के लिए बजट अलर्ट सेट करें।
- अनेक Firebase सेवाओं में अपने प्रोजेक्ट के उपयोग की समग्र तस्वीर प्राप्त करने के लिए Firebase कंसोल में उपयोग और बिलिंग डैशबोर्ड की निगरानी करें।
- फायरबेस लॉन्च चेकलिस्ट की समीक्षा करें।
Firebase और आपके Apple प्रोजेक्ट में समस्या आ रही है? Apple प्लेटफ़ॉर्म समस्या निवारण और अक्सर पूछे जाने वाले प्रश्नों पर जाएँ।
अपने ऐप्लिकेशन में Firebase सेवाएं जोड़ें:
Analytics के साथ उपयोगकर्ता के व्यवहार पर अंतर्दृष्टि प्राप्त करें।
प्रमाणीकरण के साथ उपयोगकर्ता प्रमाणीकरण सेट करें।
क्लाउड फायरस्टोर या रीयलटाइम डेटाबेस के साथ डेटा स्टोर करें, जैसे उपयोगकर्ता की जानकारी।
क्लाउड स्टोरेज के साथ फोटो और वीडियो जैसी फाइलों को स्टोर करें।
ट्रिगर बैकएंड कोड जो क्लाउड फ़ंक्शंस के साथ सुरक्षित वातावरण में चलता है।
क्लाउड मैसेजिंग के साथ सूचनाएं भेजें।
पता करें कि आपका ऐप Crashlytics के साथ कब और क्यों क्रैश हो रहा है।