Android पर इंस्टालेशन और सेटअप

अपने ऐप को फायरबेस से कनेक्ट करें

यदि आपने पहले से ऐसा नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें ।

एक डेटाबेस बनाएं

1. फायरबेस कंसोल के रीयलटाइम डेटाबेस अनुभाग पर नेविगेट करें। आपको किसी मौजूदा Firebase प्रोजेक्ट को चुनने के लिए कहा जाएगा. डेटाबेस निर्माण कार्यप्रवाह का पालन करें।

2. अपने फायरबेस सुरक्षा नियमों के लिए एक प्रारंभिक मोड चुनें:

   परीक्षण विधि

   मोबाइल और वेब क्लाइंट लाइब्रेरी के साथ शुरुआत करने के लिए अच्छा है, लेकिन किसी को भी आपके डेटा को पढ़ने और ओवरराइट करने की अनुमति देता है। परीक्षण के बाद, फायरबेस रीयलटाइम डेटाबेस नियमों को समझें अनुभाग की समीक्षा करना सुनिश्चित करें।

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

   वेब, ऐप्पल, या एंड्रॉइड एसडीके के साथ आरंभ करने के लिए, टेस्टमोड का चयन करें।

   बंद मोड

   मोबाइल और वेब क्लाइंट के सभी पढ़ने और लिखने से इनकार करते हैं। आपके प्रमाणित एप्लिकेशन सर्वर अभी भी आपके डेटाबेस तक पहुंच सकते हैं।

3. डेटाबेस के लिए एक स्थान चुनें।

   डेटाबेस के स्थान के आधार पर, नए डेटाबेस के लिए URL निम्न में से किसी एक रूप में होगा:

   • DATABASE_NAME .firebaseio.com ( us-central1 में डेटाबेस के लिए)

   • DATABASE_NAME . REGION .firebasedatabase.app (अन्य सभी स्थानों में डेटाबेस के लिए)

4. हो गया क्लिक करें.

जब आप रीयलटाइम डेटाबेस को सक्षम करते हैं, तो यह क्लाउड API प्रबंधक में API को भी सक्षम करता है।

रीयलटाइम डेटाबेस SDK को अपने ऐप्लिकेशन में जोड़ें

फायरबेस एंड्रॉइड बीओएम का उपयोग करके, अपने मॉड्यूल (ऐप-लेवल) ग्रैडल फ़ाइल (आमतौर पर app/build.gradle ) में रीयलटाइम डेटाबेस एंड्रॉइड लाइब्रेरी के लिए निर्भरता घोषित करें।

Java

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:30.1.0')

    // Declare the dependency for the Realtime Database library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-database'
}

फायरबेस एंड्रॉइड बीओएम का उपयोग करके, आपका ऐप हमेशा फायरबेस एंड्रॉइड लाइब्रेरी के संगत संस्करणों का उपयोग करेगा।

(वैकल्पिक) BoM . का उपयोग किए बिना फायरबेस लाइब्रेरी निर्भरता घोषित करें

यदि आप फायरबेस बीओएम का उपयोग नहीं करना चुनते हैं, तो आपको प्रत्येक फायरबेस लाइब्रेरी संस्करण को उसकी निर्भरता रेखा में निर्दिष्ट करना होगा।

ध्यान दें कि यदि आप अपने ऐप में एकाधिक फायरबेस लाइब्रेरी का उपयोग करते हैं, तो हम लाइब्रेरी संस्करणों को प्रबंधित करने के लिए BoM का उपयोग करने की अत्यधिक अनुशंसा करते हैं, जो सुनिश्चित करता है कि सभी संस्करण संगत हैं।

dependencies {
    // Declare the dependency for the Realtime Database library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-database:20.0.5'
}

Kotlin+KTX

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:30.1.0')

    // Declare the dependency for the Realtime Database library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-database-ktx'
}

फायरबेस एंड्रॉइड बीओएम का उपयोग करके, आपका ऐप हमेशा फायरबेस एंड्रॉइड लाइब्रेरी के संगत संस्करणों का उपयोग करेगा।

(वैकल्पिक) BoM . का उपयोग किए बिना फायरबेस लाइब्रेरी निर्भरता घोषित करें

यदि आप फायरबेस बीओएम का उपयोग नहीं करना चुनते हैं, तो आपको प्रत्येक फायरबेस लाइब्रेरी संस्करण को उसकी निर्भरता रेखा में निर्दिष्ट करना होगा।

ध्यान दें कि यदि आप अपने ऐप में एकाधिक फायरबेस लाइब्रेरी का उपयोग करते हैं, तो हम लाइब्रेरी संस्करणों को प्रबंधित करने के लिए BoM का उपयोग करने की अत्यधिक अनुशंसा करते हैं, जो सुनिश्चित करता है कि सभी संस्करण संगत हैं।

dependencies {
    // Declare the dependency for the Realtime Database library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-database-ktx:20.0.5'
}

रीयलटाइम डेटाबेस नियम कॉन्फ़िगर करें

रीयलटाइम डेटाबेस एक घोषणात्मक नियम भाषा प्रदान करता है जो आपको यह परिभाषित करने की अनुमति देता है कि आपके डेटा को कैसे संरचित किया जाना चाहिए, इसे कैसे अनुक्रमित किया जाना चाहिए, और आपके डेटा को कब से पढ़ा और लिखा जा सकता है।

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

अपने डेटाबेस में लिखें

getInstance() का उपयोग करके अपने डेटाबेस का एक उदाहरण पुनर्प्राप्त करें और उस स्थान का संदर्भ लें जिसे आप लिखना चाहते हैं।

महत्वपूर्ण : us-central1 डिफ़ॉल्ट डेटाबेस के अलावा किसी अन्य डेटाबेस का संदर्भ प्राप्त करने के लिए, आपको डेटाबेस URL को getInstance() (या Kotlin+KTX database() के लिए) पास करना होगा। us-central1 डिफ़ॉल्ट डेटाबेस के लिए, आप बिना तर्क के getInstance() (या database ) को कॉल कर सकते हैं।

आप अपना रीयलटाइम डेटाबेस URL Firebase कंसोल के रीयलटाइम डेटाबेस अनुभाग में पा सकते हैं। डेटाबेस के स्थान के आधार पर, डेटाबेस URL निम्न रूपों में से एक में होगा:

• https:// DATABASE_NAME .firebaseio.com ( us-central1 में डेटाबेस के लिए)
• https:// DATABASE_NAME . REGION .firebasedatabase.app (अन्य सभी स्थानों में डेटाबेस के लिए)

Java

// Write a message to the database
FirebaseDatabase database = FirebaseDatabase.getInstance();
DatabaseReference myRef = database.getReference("message");

myRef.setValue("Hello, World!");
MainActivity.java

Kotlin+KTX

// Write a message to the database
val database = Firebase.database
val myRef = database.getReference("message")

myRef.setValue("Hello, World!")
MainActivity.kt

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

अपने डेटाबेस से पढ़ें

अपने ऐप डेटा को रीयलटाइम में अपडेट करने के लिए, आपको अभी-अभी बनाए गए संदर्भ में एक ValueEventListener जोड़ना चाहिए।

इस वर्ग में onDataChange() विधि एक बार चालू हो जाती है जब श्रोता संलग्न होता है और फिर से हर बार डेटा बदलता है, जिसमें बच्चे भी शामिल हैं।

Java

// Read from the database
myRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(DataSnapshot dataSnapshot) {
        // This method is called once with the initial value and again
        // whenever data at this location is updated.
        String value = dataSnapshot.getValue(String.class);
        Log.d(TAG, "Value is: " + value);
    }

    @Override
    public void onCancelled(DatabaseError error) {
        // Failed to read value
        Log.w(TAG, "Failed to read value.", error.toException());
    }
});
MainActivity.java

Kotlin+KTX

// Read from the database
myRef.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(dataSnapshot: DataSnapshot) {
        // This method is called once with the initial value and again
        // whenever data at this location is updated.
        val value = dataSnapshot.getValue<String>()
        Log.d(TAG, "Value is: $value")
    }

    override fun onCancelled(error: DatabaseError) {
        // Failed to read value
        Log.w(TAG, "Failed to read value.", error.toException())
    }
})
MainActivity.kt

वैकल्पिक: प्रोगार्ड कॉन्फ़िगर करें

ProGuard के साथ अपने ऐप में Firebase रीयलटाइम डेटाबेस का उपयोग करते समय, आपको यह विचार करने की आवश्यकता है कि अस्पष्टता के बाद आपके मॉडल ऑब्जेक्ट को कैसे क्रमबद्ध और deserialized किया जाएगा। यदि आप डेटा पढ़ने और लिखने के लिए DataSnapshot.getValue(Class) या DatabaseReference.setValue(Object) का उपयोग करते हैं, तो आपको proguard-rules.pro फ़ाइल में नियम जोड़ने होंगे:

    # Add this global rule
    -keepattributes Signature

    # This rule will properly ProGuard all the model classes in
    # the package com.yourcompany.models.
    # Modify this rule to fit the structure of your app.
    -keepclassmembers class com.yourcompany.models.** {
      *;
    }

ProGuard से संबंधित प्रश्नों या मुद्दों के लिए सहायता प्राप्त करने के लिए, किसी विशेषज्ञ से सहायता प्राप्त करने के लिए Guardsquare समुदाय फ़ोरम पर जाएँ।

लॉन्च की तैयारी करें

आपका ऐप लॉन्च करने से पहले, हम यह सुनिश्चित करने के लिए हमारी लॉन्च चेकलिस्ट के माध्यम से चलने की सलाह देते हैं कि आपका ऐप जाने के लिए तैयार है!

यह सुनिश्चित करने में सहायता के लिए ऐप चेक सक्षम करना सुनिश्चित करें कि केवल आपके ऐप्स ही आपके डेटाबेस तक पहुंच सकते हैं।

अगले कदम

• रीयलटाइम डेटाबेस के लिए डेटा की संरचना करना सीखें
• अपने डेटा को कई डेटाबेस इंस्टेंस में स्केल करें ।
• डेटा पढ़ें और लिखें ।
• Firebase कंसोल में अपना डेटाबेस देखें ।