Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

חבר את האפליקציה שלך ל- 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.4.2')

    // 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.2'
}

קוטלין+KTX

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

    // 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.2'
}

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

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

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

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

ג'אווה

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

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

קוטלין+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());
    }
});

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

הצעדים הבאים