Firebase प्रोजेक्ट को समझें

यह पृष्ठ Firebase परियोजनाओं के बारे में कई महत्वपूर्ण अवधारणाओं का संक्षिप्त विवरण प्रस्तुत करता है। उपलब्ध होने पर, सुविधाओं, सेवाओं और यहां तक ​​कि अन्य प्लेटफार्मों के बारे में अधिक विस्तृत जानकारी प्राप्त करने के लिए लिंक का अनुसरण करें। इस पेज के सबसे नीचे, की एक सूची को खोजने के सामान्य श्रेष्ठ व्यवहारों Firebase परियोजनाओं के लिए।

Firebase प्रोजेक्ट, ऐप्लिकेशन और उत्पादों के बीच संबंध

Firebase प्रोजेक्ट, Firebase के लिए शीर्ष-स्तरीय इकाई है। किसी प्रोजेक्ट में, आप अपने iOS, Android या वेब ऐप को रजिस्टर करके Firebase ऐप बनाते हैं। आप Firebase के साथ अपने पंजीकृत एप्लिकेशन के बाद, आप के किसी भी संख्या के लिए Firebase SDKs जोड़ सकते हैं Firebase उत्पादों , Analytics, बादल Firestore, प्रदर्शन की निगरानी, या रिमोट कॉन्फिग।

प्रारंभ गाइड में इस प्रक्रिया के बारे में अधिक विस्तृत जानकारी जानें ( आईओएस | एंड्रॉयड | वेब | एकता | सी ++ )।

Firebase प्रोजेक्ट और Google क्लाउड के बीच संबंध

जब आप Firebase console में नई Firebase परियोजना बनाने, आप वास्तव में एक बना रहे हैं Google मेघ परियोजना पर्दे के पीछे। आप Google क्लाउड प्रोजेक्ट को डेटा, कोड, कॉन्फ़िगरेशन और सेवाओं के लिए वर्चुअल कंटेनर के रूप में सोच सकते हैं। Firebase प्रोजेक्ट एक Google क्लाउड प्रोजेक्ट है जिसमें अतिरिक्त Firebase-विशिष्ट कॉन्फ़िगरेशन और सेवाएं हैं। आप पहले एक Google क्लाउड प्रोजेक्ट भी बना सकते हैं, फिर बाद में प्रोजेक्ट में Firebase जोड़ सकते हैं।

एक Firebase परियोजना के बाद से एक Google मेघ परियोजना है:

Firebase प्रोजेक्ट सेट अप करना और ऐप्स पंजीकृत करना

आप एक Firebase परियोजना की स्थापना कर सकते हैं और रजिस्टर में क्षुधा Firebase कंसोल (उन्नत उपयोग के मामलों के लिए या, के माध्यम से Firebase प्रबंधन REST API या Firebase CLI )। जब आप कोई प्रोजेक्ट सेट अप करते हैं और ऐप्स पंजीकृत करते हैं, तो आपको कुछ संगठनात्मक निर्णय लेने होते हैं और अपने स्थानीय प्रोजेक्ट में Firebase-विशिष्ट कॉन्फ़िगरेशन जानकारी जोड़ने की आवश्यकता होती है।

कुछ की समीक्षा अवश्य करें सामान्य परियोजना स्तरीय सर्वोत्तम प्रथाओं एक परियोजना की स्थापना और क्षुधा पंजीकरण से पहले (इस पृष्ठ के तल पर)।

परियोजना का नाम

जब आप किसी प्रोजेक्ट बनाते हैं, तो आप एक परियोजना का नाम प्रदान करते हैं। इस पहचानकर्ता में एक परियोजना के लिए केवल-आंतरिक नाम है Firebase कंसोल , Google क्लाउड कंसोल , और Firebase CLI । परियोजना का नाम सार्वजनिक रूप से दिखाई देने वाले किसी भी Firebase या Google क्लाउड उत्पाद, सेवा या संसाधन में प्रकट नहीं होता है; यह बस आपको कई परियोजनाओं के बीच अधिक आसानी से अंतर करने में मदद करता है।

आप में किसी भी समय एक परियोजना का नाम संपादित कर सकते हैं परियोजना सेटिंग्स Firebase सांत्वना की। प्रोजेक्ट का नाम शीर्ष फलक में प्रदर्शित होता है।

परियोजना संख्या

एक Firebase परियोजना (और उसके संबंधित Google क्लाउड परियोजना ) एक परियोजना संख्या है। यह परियोजना के लिए वैश्विक रूप से अद्वितीय विहित पहचानकर्ता Google द्वारा असाइन किया गया है। एकीकरण को कॉन्फ़िगर करते समय और/या Firebase, Google, या तृतीय-पक्ष सेवाओं के लिए API कॉल करते समय इस पहचानकर्ता का उपयोग करें।

एपीआई कॉल और प्रोजेक्ट नंबर

कई API कॉल के लिए, आपको किसी प्रोजेक्ट के लिए एक विशिष्ट पहचानकर्ता शामिल करना होगा। हालांकि कई एपीआई स्वीकार परियोजना आईडी , यह अनुशंसा की जाती है कि आप Firebase, गूगल, या तीसरे पक्ष की सेवाओं के लिए एपीआई कॉल करने के लिए परियोजना संख्या का उपयोग करें।

परियोजना पहचानकर्ता का उपयोग कर, विशेष रूप से परियोजना संख्या, गूगल के में बारे में और जानें AIP 2510 मानक

प्रोजेक्ट नंबर खोजें

  • Firebase कंसोल: क्लिक करें परियोजना सेटिंग्स । प्रोजेक्ट नंबर शीर्ष फलक में प्रदर्शित होता है।

  • Firebase CLI: भागो firebase projects:list । प्रोजेक्ट नंबर आपके खाते से संबद्ध सभी Firebase प्रोजेक्ट के साथ प्रदर्शित होता है।

  • Firebase प्रबंधन REST API: कॉल projects.list । प्रतिक्रिया शरीर में परियोजना नंबर शामिल FirebaseProject वस्तु।

परियोजना आईडी

एक Firebase परियोजना (और उसके संबंधित Google क्लाउड परियोजना ) एक प्रोजेक्ट आईडी है। यह पूरे Firebase और Google क्लाउड में प्रोजेक्ट के लिए उपयोगकर्ता द्वारा परिभाषित विशिष्ट पहचानकर्ता है। जब आप कोई Firebase प्रोजेक्ट बनाते हैं, तो Firebase प्रोजेक्ट को स्वचालित रूप से एक अद्वितीय आईडी असाइन करता है, लेकिन आप प्रोजेक्ट सेटअप के दौरान इसे संपादित कर सकते हैं। इस पहचानकर्ता को आम तौर पर परियोजना को संदर्भित करने के लिए एक सुविधा उपनाम के रूप में माना जाना चाहिए।

यदि आप किसी प्रोजेक्ट को हटाते हैं, तो प्रोजेक्ट आईडी भी हटा दिया जाता है और किसी अन्य प्रोजेक्ट द्वारा फिर कभी इसका उपयोग नहीं किया जा सकता है।

फायरबेस संसाधन और प्रोजेक्ट आईडी

प्रोजेक्ट आईडी सार्वजनिक रूप से दिखाई देने वाले Firebase संसाधनों में प्रदर्शित होता है, उदाहरण के लिए:

  • डिफ़ॉल्ट होस्टिंग उपडोमेन - PROJECT_ID .web.app और PROJECT_ID .firebaseapp.com
  • डिफ़ॉल्ट रीयलटाइम डाटाबेस यूआरएल - PROJECT_ID -default-rtdb.firebaseio.com या PROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
  • डिफ़ॉल्ट क्लाउड मेमोरी बकेट नाम - PROJECT_ID .appspot.com

उपरोक्त सभी संसाधनों के लिए, आप गैर-डिफ़ॉल्ट उदाहरण बना सकते हैं। गैर-डिफ़ॉल्ट के सार्वजनिक रूप से दृश्यमान नाम पूरी तरह से अनुकूलन योग्य हैं। आप कर सकते हैं कस्टम डोमेन कनेक्ट , एक Firebase की मेजबानी की साइट के लिए रीयलटाइम डाटाबेस ठीकरा , और कई क्लाउड संग्रहण बाल्टी बनाने (प्लेटफ़ॉर्म-विशिष्ट प्रारंभ करें पृष्ठ पर जाएँ)।

फायरबेस सीएलआई और प्रोजेक्ट आईडी

कुछ उपयोग मामलों के लिए, आपके पास एक ही स्थानीय ऐप निर्देशिका से संबद्ध एकाधिक Firebase प्रोजेक्ट हो सकते हैं। इन स्थितियों में, जब आप का उपयोग Firebase CLI , आप पास करनी होगी --project साथ ध्वज firebase जो Firebase परियोजना आप के साथ बातचीत करना चाहते हैं संवाद करने के लिए आदेशों।

तुम भी एक सेट कर सकते हैं परियोजना उर्फ ताकि आप परियोजना आईडी याद करने की जरूरत नहीं है प्रत्येक Firebase परियोजना के लिए।

एपीआई कॉल और प्रोजेक्ट आईडी

कई API कॉल के लिए, आपको किसी प्रोजेक्ट के लिए एक विशिष्ट पहचानकर्ता शामिल करना होगा। हालांकि कई एपीआई परियोजना आईडी स्वीकार करते हैं, यह अनुशंसित है कि आप का उपयोग परियोजना संख्या Firebase, गूगल, या तीसरे पक्ष की सेवाओं के लिए एपीआई कॉल करने के लिए।

परियोजना पहचानकर्ता का उपयोग कर, विशेष रूप से परियोजना संख्या, गूगल के में बारे में और जानें AIP 2510 मानक

प्रोजेक्ट आईडी खोजें

  • Firebase कंसोल: क्लिक करें परियोजना सेटिंग्स । प्रोजेक्ट आईडी शीर्ष फलक में प्रदर्शित होता है।

  • Firebase CLI: भागो firebase projects:list । प्रोजेक्ट आईडी आपके खाते से संबद्ध सभी Firebase प्रोजेक्ट के साथ प्रदर्शित होता है।

  • Firebase प्रबंधन REST API: कॉल projects.list । प्रतिक्रिया शरीर में परियोजना आईडी है FirebaseProject वस्तु।

फायरबेस कॉन्फिग फाइल्स और ऑब्जेक्ट्स

जब आप किसी ऐप को Firebase प्रोजेक्ट के साथ पंजीकृत करते हैं, तो Firebase कंसोल एक Firebase कॉन्फ़िगरेशन फ़ाइल (iOS/Android ऐप्स) या एक कॉन्फ़िगरेशन ऑब्जेक्ट (वेब ​​ऐप्स) प्रदान करता है जिसे आप सीधे अपनी स्थानीय ऐप निर्देशिका में जोड़ते हैं।

  • IOS एप्लिकेशन के लिए, आप एक जोड़ने GoogleService-Info.plist विन्यास फाइल।
  • Android ऐप्लिकेशन के लिए, आप एक जोड़ने google-services.json विन्यास फाइल।
  • वेब ऐप्स के लिए, आप एक Firebase कॉन्फ़िगरेशन ऑब्जेक्ट जोड़ते हैं।

किसी भी समय, आप कर सकते हैं किसी ऐप के Firebase कॉन्फ़िग फ़ाइल या वस्तु प्राप्त

Firebase कॉन्फ़िग फ़ाइल या ऑब्जेक्ट किसी ऐप्लिकेशन को किसी खास Firebase प्रोजेक्ट और उसके संसाधनों (डेटाबेस, स्टोरेज बकेट, वगैरह) से जोड़ता है. कॉन्फ़िगरेशन में "Firebase विकल्प" शामिल हैं, जो Firebase और Google सेवाओं द्वारा Firebase सर्वर API के साथ संचार करने और क्लाइंट डेटा को Firebase प्रोजेक्ट और Firebase ऐप से संबद्ध करने के लिए आवश्यक पैरामीटर हैं। यहां आवश्यक, न्यूनतम "Firebase विकल्प" दिए गए हैं:

  • API कुंजी : एक सरल एन्क्रिप्टेड जब कुछ API को कॉल इस्तेमाल किया स्ट्रिंग है जो पहुँच निजी उपयोगकर्ता डेटा की जरूरत नहीं है (उदाहरण के मूल्य: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • परियोजना आईडी : उपयोगकर्ता परिभाषित Firebase और Google क्लाउड के सभी भर में इस परियोजना के लिए अद्वितीय पहचानकर्ता। यह पहचानकर्ता कुछ Firebase संसाधनों के URL या नामों में दिखाई दे सकता है, लेकिन इसे आम तौर पर प्रोजेक्ट को संदर्भित करने के लिए एक सुविधा उपनाम के रूप में माना जाना चाहिए। (उदाहरण के मूल्य: myapp-project-123 )

  • अनुप्रयोग ID ( "AppID"): एक प्लेटफ़ॉर्म-विशिष्ट प्रारूप के साथ Firebase के सभी भर में Firebase ऐप्लिकेशन की अनन्य पहचानकर्ता:

    • Firebase आईओएस ऐप्लिकेशन: GOOGLE_APP_ID (उदाहरण के मूल्य: 1:1234567890:ios:321abc456def7890 )
      यह एक एप्पल बंडल आईडी नहीं है।
    • Firebase Android एप्लिकेशन: mobilesdk_app_id (उदाहरण के मूल्य: 1:1234567890:android:321abc456def7890 )
      यह एक Android पैकेज का नाम या Android एप्लिकेशन आईडी नहीं है।
    • Firebase वेब एप्लिकेशन: appId (उदाहरण के मूल्य: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

फ़ायरबेस कॉन्फ़िग फ़ाइल या ऑब्जेक्ट की सामग्री को सार्वजनिक माना जाता है, जिसमें ऐप की प्लेटफ़ॉर्म-विशिष्ट आईडी (आईओएस बंडल आईडी या एंड्रॉइड पैकेज नाम) और फायरबेस प्रोजेक्ट-विशिष्ट मान, जैसे एपीआई कुंजी, प्रोजेक्ट आईडी, रीयलटाइम डेटाबेस यूआरएल, और क्लाउड स्टोरेज बकेट नाम। इस को देखते हुए, उपयोग Firebase सुरक्षा नियम में अपने डेटा और फ़ाइलों की रक्षा करने के लिए रीयलटाइम डाटाबेस , बादल Firestore , और क्लाउड संग्रह

ओपन सोर्स प्रोजेक्ट के लिए, हम आम तौर पर ऐप की फ़ायरबेस कॉन्फ़िगरेशन फ़ाइल या ऑब्जेक्ट को स्रोत नियंत्रण में शामिल करने की अनुशंसा नहीं करते हैं, क्योंकि ज्यादातर मामलों में, आपके उपयोगकर्ताओं को अपने स्वयं के फायरबेस प्रोजेक्ट बनाने चाहिए और अपने ऐप्स को अपने स्वयं के फायरबेस संसाधनों पर इंगित करना चाहिए (अपने स्वयं के फायरबेस कॉन्फ़िगरेशन के माध्यम से) फ़ाइल या वस्तु)।

Firebase प्रोजेक्ट प्रबंधित करना

समीक्षा अवश्य करें सामान्य परियोजना स्तरीय सर्वोत्तम प्रथाओं विचार के लिए को प्रभावित कर सकता है कि कैसे आप एक Firebase परियोजना प्रबंधन (इस पृष्ठ के तल पर)।

एक परियोजना का प्रबंधन करने के लिए उपकरण

फायरबेस कंसोल

Firebase सांत्वना प्रदान करता है Firebase उत्पादों, ऐप्स और परियोजना स्तरीय सेटिंग का प्रबंधन करने के लिए सबसे अमीर वातावरण।

फायरबेस कंसोल - प्रोजेक्ट ओवरव्यू स्क्रीन

कंसोल के बाईं ओर का पैनल शीर्ष-स्तरीय श्रेणियों द्वारा आयोजित फायरबेस उत्पादों को सूचीबद्ध करता है। बाईं ओर के पैनल, पहुंच पर क्लिक करके एक परियोजना की सेटिंग के शीर्ष पर । एक परियोजना की सेटिंग शामिल एकीकरण , पहुँच अनुमतियाँ , और बिलिंग

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

फायरबेस सीएलआई (एक कमांड लाइन टूल)

Firebase भी प्रदान करता है Firebase CLI विन्यस्त और प्रबंध विशिष्ट Firebase उत्पादों, जैसे Firebase होस्टिंग और Firebase के लिए बादल कार्य के लिए।

CLI को स्थापित करने के बाद, आप के लिए उपयोग किया वैश्विक firebase आदेश । करने के लिए CLI का प्रयोग करें एक Firebase परियोजना के लिए अपने स्थानीय एप्लिकेशन निर्देशिका लिंक , तो तैनात या कार्यों के लिए Firebase होस्ट की गई सामग्री के नए संस्करणों को अद्यतन।

फायरबेस प्रबंधन बाकी एपीआई

का उपयोग करते हुए Firebase प्रबंधन REST API , आप प्रोग्राम एक Firebase परियोजना प्रबंधन कर सकते हैं। उदाहरण के लिए, आप प्रोग्राम एक परियोजना के साथ एप्लिकेशन रजिस्टर या एप्लिकेशन पहले से ही पंजीकृत हैं सूचीबद्ध कर सकते हैं ( आईओएस | एंड्रॉयड | वेब )।

सामान्य सर्वोत्तम अभ्यास

किसी प्रोजेक्ट में ऐप्स जोड़ना

सुनिश्चित करें कि एक परियोजना के भीतर सभी क्षुधा एक अंतिम-उपयोगकर्ता के नजरिए से एक ही ऐप्लिकेशन के प्लेटफ़ॉर्म वेरिएंट हैं। एक ही ऐप या गेम के आईओएस, एंड्रॉइड और वेब संस्करणों को एक ही फायरबेस प्रोजेक्ट के साथ पंजीकृत करने की सलाह दी जाती है। किसी प्रोजेक्ट के सभी ऐप्स आम तौर पर समान Firebase संसाधन (डेटाबेस, स्टोरेज बकेट, आदि) साझा करते हैं।

यदि आप एक से अधिक निर्माण वेरिएंट के साथ विभिन्न iOS आईडी या एंड्रॉयड पैकेज के नाम परिभाषित बंडल है, तो आपको एक अलग Firebase परियोजना के साथ प्रत्येक प्रकार के रजिस्टर कर सकते हैं। हालांकि, कि शेयर वेरिएंट ही Firebase संसाधन, उन्हें एक ही Firebase परियोजना के साथ रजिस्टर अगर आप की है।

यहां Firebase प्रोजेक्ट, ऐप्लिकेशन और साइटों के लिए कुछ सामान्य सीमाएं दी गई हैं:

  • प्रति खाता परियोजनाओं की संख्या

    • स्पार्क मूल्य निर्धारण योजना - परियोजना-निर्माण कोटा परियोजनाओं की कम संख्या (आमतौर पर लगभग 5-10) तक सीमित है।
    • ब्लेज़ मूल्य निर्धारण योजना — जब तक संबद्ध क्लाउड बिलिंग खाता अच्छी स्थिति में है, तब तक प्रति खाता परियोजना-निर्माण कोटा काफी बढ़ जाता है।

    परियोजना निर्माण कोटा पर सीमा शायद ही कभी सबसे डेवलपर्स के लिए एक चिंता का विषय है, लेकिन यदि आवश्यक हो तो, आप कर सकते हैं परियोजना कोटा में वृद्धि करने का अनुरोध

    ध्यान रखें कि किसी प्रोजेक्ट को पूरी तरह से हटाने के लिए 30 दिनों की आवश्यकता होती है और प्रोजेक्ट को पूरी तरह से हटाए जाने तक प्रोजेक्ट कोटा में गिना जाता है।

  • प्रति प्रोजेक्ट ऐप्स की संख्या

    Firebase किसी Firebase प्रोजेक्ट में Firebase ऐप्लिकेशन की कुल संख्या को 30 तक सीमित करता है।

    आपको यह सुनिश्चित करना चाहिए कि एक ही Firebase प्रोजेक्ट के सभी Firebase ऐप्स अंतिम-उपयोगकर्ता के दृष्टिकोण से एक ही एप्लिकेशन के प्लेटफ़ॉर्म वेरिएंट हैं। के लिए सर्वोत्तम प्रथाओं के बारे में और अधिक पढ़ें बहु किरायेदारी नीचे।

    बारे में और जानें परियोजना प्रति क्षुधा पर सीमा सवाल जवाब में।

  • प्रति प्रोजेक्ट होस्टिंग साइटों की संख्या

    Firebase एकाधिक सुविधा होस्टिंग परियोजना प्रति 36 साइटों की एक अधिकतम समर्थन करता है।

बहु किरायेदारी

कई अलग-अलग तार्किक रूप से स्वतंत्र ऐप्स और/या वेब साइटों को एक एकल फायरबेस प्रोजेक्ट (जिसे अक्सर "मल्टी-टेनेंसी" कहा जाता है) से कनेक्ट करने की अनुशंसा नहीं की जाती है। बहु-किरायेदारी गंभीर कॉन्फ़िगरेशन और डेटा गोपनीयता संबंधी समस्याओं को जन्म दे सकती है, जिसमें एनालिटिक्स एकत्रीकरण के साथ अनपेक्षित मुद्दे, साझा प्रमाणीकरण, अत्यधिक जटिल डेटाबेस संरचनाएं और सुरक्षा नियमों के साथ कठिनाइयां शामिल हैं।

आम तौर पर, एप्लिकेशन का एक समूह एक ही डेटा और विन्यास का हिस्सा नहीं है, दृढ़ता से एक अलग Firebase परियोजना के साथ प्रत्येक अनुप्रयोग पंजीकृत करने पर विचार।

उदाहरण के लिए, यदि आप एक सफेद लेबल एप्लिकेशन विकसित करते हैं, तो प्रत्येक स्वतंत्र रूप से लेबल किए गए ऐप का अपना फायरबेस प्रोजेक्ट होना चाहिए, लेकिन उस लेबल के आईओएस और एंड्रॉइड संस्करण एक ही प्रोजेक्ट में हो सकते हैं। प्रत्येक स्वतंत्र रूप से लेबल किए गए ऐप को (गोपनीयता कारणों से) दूसरों के साथ डेटा साझा नहीं करना चाहिए।

अपना ऐप लॉन्च करना