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

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

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

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

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

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

    מצב מבחן

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

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

    מצב נעול

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

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

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

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

הוסף את ה- SDK של Realtime Database לאפליקציה שלך

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

ג'אווה

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

על ידי שימוש ב- Firebase Android BoM , היישום שלך ישתמש תמיד בגרסאות תואמות של ספריות Android ל- 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.0'
}

Kotlin + KTX

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

על ידי שימוש ב- Firebase Android BoM , היישום שלך ישתמש תמיד בגרסאות תואמות של ספריות Android ל- 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.0'
}

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

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

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

אחזר מופע של מסד הנתונים שלך באמצעות getInstance() למיקום 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() בכיתה זו מופעלת פעם אחת 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 כדי לקבל סיוע ממומחה.

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

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

הקפד להפעיל את בדיקת האפליקציות כדי להבטיח שרק האפליקציות שלך יכולות לגשת למאגרי המידע שלך.

הצעדים הבאים