התקנה והתקנה באנדרואיד

חבר את האפליקציה שלך ל- Firebase

אם לא עשית זאת עדיין, להוסיף Firebase לפרויקט Android שלך .

צור מסד נתונים

  1. נווט אל המקטע מסד זמן אמת של קונסולת Firebase . תתבקש לבחור פרוייקט Firebase קיים. עקוב אחר זרימת העבודה ליצירת מסד נתונים.

  2. בחר מצב התחלה לכללי האבטחה שלך ב- Firebase:

    מצב מבחן

    טוב להתחלה עם ספריות הלקוחות הניידים והרשתיים, אך מאפשר לכל אחד לקרוא ולהחליף את הנתונים שלך. לאחר שבחנו, הקפד לבדוק את חוקי מסד להבין Firebase זמן אמת סעיף.

    כדי להתחיל לעבוד עם האינטרנט, iOS או Android SDK, בחר במצב בדיקה.

    מצב נעול

    מכחיש את כל הקריאה והכתיבה מלקוחות סלולריים ואינטרנט. שרתי היישומים המאומתים שלך עדיין יכולים לגשת למסד הנתונים שלך.

  3. בחר אזור למסד הנתונים. בהתאם לבחירה של האזור שלך, מרחב הנתונים יהיה מהצורה <databaseName>.firebaseio.com או <databaseName>.<region>.firebasedatabase.app . לקבלת מידע נוסף, ראו במיקומים נבחרים עבור הפרויקט שלך .

  4. לחץ על סיום.

כשמפעילים מסד זמן אמת, זה גם מאפשר API של מנהל API ענן .

הוסף את SDK מסד הנתונים בזמן אמת לאפליקציה שלך

באמצעות BOM Firebase אנדרואיד , להכריז על התלות של הספרייה זמן אמת מסד אנדרואיד במודול שלך (ברמת היישום) קובץ Gradle (בדרך כלל app/build.gradle ).

ג'אווה

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:28.3.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'
}

באמצעות Firebase אנדרואיד BOM , האפליקציה שלך תמיד ישתמשו גירסאות תואמות של ספריות אנדרואיד Firebase.

(אלטרנטיבי) הצהר תלות הספרייה Firebase ללא שימוש BOM

אם תבחר לא להשתמש ב- Firebase BoM, עליך לציין כל גרסת ספריית Firebase בשורת התלות שלה.

שים לב שאם אתה משתמש בספריות Firebase מרובים באפליקציה, אנו ממליצים בחום להשתמש בתמונה 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.1'
}

Kotlin + KTX

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:28.3.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'
}

באמצעות Firebase אנדרואיד BOM , האפליקציה שלך תמיד ישתמשו גירסאות תואמות של ספריות אנדרואיד Firebase.

(אלטרנטיבי) הצהר תלות הספרייה Firebase ללא שימוש BOM

אם תבחר לא להשתמש ב- Firebase BoM, עליך לציין כל גרסת ספריית Firebase בשורת התלות שלה.

שים לב שאם אתה משתמש בספריות Firebase מרובים באפליקציה, אנו ממליצים בחום להשתמש בתמונה 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.1'
}

הגדר כללי מסדי נתונים בזמן אמת

מאגר המידע בזמן אמת מספק שפת כללים הצהרתית המאפשרת לך להגדיר כיצד יש לבנות את הנתונים שלך, כיצד יש להוסיף אותם לאינדקס ומתי ניתן לקרוא אותם ולכתוב אותם.

כתוב למסד הנתונים שלך

אחזר מופע של מסד הנתונים שלך באמצעות getInstance() וציין את המיקום שאתה רוצה לכתוב.

ג'אווה

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

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

Kotlin + KTX

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

myRef.setValue("Hello, World!")

באפשרותך לשמור מגוון סוגי נתונים במסד הנתונים בדרך זו, כולל אובייקטים של Java. כשאתה שומר אובייקט התגובות מכל קולטנים יישמרו כילדים של מיקום זה.

קרא ממאגר המידע שלך

כדי להפוך עדכון נתוני האפליקציות בזמן אמת, אתה צריך להוסיף ValueEventListener להתייחסות שיצרתם.

onDataChange() שיטה בכיתה זו מופעלת פעם אחת כאשר המאזין מצורפת ושוב בכל פעם את השינויים הנתונים, כולל ילדים.

ג'אווה

// 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());
    }
});

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())
    }
})

אופציונלי: הגדר את ProGuard

כשאתה משתמש במסד נתונים בזמן אמת של Firebase באפליקציה שלך יחד עם ProGuard, עליך לשקול כיצד אובייקטים המודל שלך יסודרו ויעברו הערכה לאחר ערפול. אם אתה משתמש 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 כדי לקבל סיוע ממומחה.

התכונן להפעלה

לפני השקת האפליקציה, אנו ממליצים הליכת הדרך שלנו checklist ההשקה לוודא שהאפליקציה לא מוכנה ללכת!

הקפד לאפשר App Check כדי לעזור להבטיח שרק האפליקציות יכולות לגשת למסדי הנתונים שלך.

הצעדים הבאים