למידע נוסף על Android ו- Firebase

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

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

תוסף Firebase Assistant לאנדרואיד סטודיו

ה- Firebase Assistant הוא תוסף ל- Android Studio אשר רושם את אפליקציית האנדרואיד שלך בפרויקט Firebase ומוסיף את קובצי התצורה, התוספים והתלות של Firebase הדרושים לפרויקט Android שלך - הכל מתוך Android Studio!

בצע את הוראות אנדרואיד מקבלות דף נכתב להשתמש עזר Firebase. ודא כי אתה משתמש עַדכָּנִי גרסאות ביותר של שניהם סטודיו אנדרואיד ואת עוזר Firebase (ללכת על קובץ> בדוק אם יש עדכונים).

כאשר אתה בוחר ספציפית מוצרים Firebase להוסיף לאפליקציה שלכם, Firebase עוזר אוטומטי מצהיר את התלות הנדרשת שלך app/build.gradle קובץ. עם זאת, כדי להשתמש בתכונות Firebase החורגות מהיכולות הנוכחיות של Firebase Assistant, ייתכן שתרצה לבצע כמה שינויים ידניים בתלות אלה:

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

  • אם אתה רוצה להשתמש בספריית הרחבות Kotlin , לשנות את קו תלות להוסיף מודול שלך (ברמת היישום) קובץ Gradle (בדרך כלל app/build.gradle ) להשתמש ktx בגרסה של ספריית Firebase במקום.

שירותי Google - תוסף וקובץ config

כחלק הוספת Firebase לפרויקט Android שלך, אתה צריך להוסיף את google-services תוסף לבין google-services.json קובץ תצורה לפרויקט שלך.

אם אתה מוסיף Firebase לפרויקט Android שלך באמצעות הקונסולה Firebase , את ה- API ניהול REST , או Firebase CLI , עליך להוסיף ידנית את התוסף קובץ config לפרויקט שלך. עם זאת, אם אתה משתמש עוזר Firebase , משימות אלה נעשים עבורך באופן אוטומטי במהלך ההתקנה.

בקר תיעוד אנדרואיד כדי ללמוד על האופן שבו שירותי Google תוסף ועבודה קובץ config יחד.

Firebase Android BoM (כתב חומרים)

Firebase Android BoM (שטר החומרים) מאפשר לך לנהל את כל גרסאות ספריית Firebase שלך ​​על ידי ציון גרסה אחת בלבד - גרסת ה- BoM.

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

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

למידע נוסף על התמיכה של Gradle לפלטפורמות BOM .

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

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

  // Declare the dependencies for the desired Firebase products without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

להלן מספר שאלות נפוצות בנוגע לשימוש ב- Firebase Android BoM:

השווה את גרסאות ה- Firebase BoM

ספריות תוספי Kotlin (KTX)

ספריות תוספי Kotlin של Firebase (KTX) הם שותפים קטנים למסכי ה- SDK הבסיסיים של Firebase המאפשרים לך לכתוב קוד Kotlin יפהפה ואדיומטי.

כדי להשתמש בספריית קטקס באפליקציה, לשנות את התלות שלך לכלול את -ktx הסיומת. לכל ספריית KTX יש תלות באופן אוטומטי בספריית הבסיס, כך שאין צורך לכלול את שתי התלות באפליקציה שלך.

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

  // Declare the base library
  implementation 'com.google.firebase:firebase-analytics'

  // Declare the KTX library instead (which automatically has a dependency on the base library)
  implementation 'com.google.firebase:firebase-analytics-ktx'
}

כל ספריית KTX מספקת הרחבות תחביריות שונות של ספריית הבסיס. לדוגמה, ספריית KTX של Analytics מקלה על רישום אירועים:

לפני (באמצעות ספריית הבסיס)

val analytics = FirebaseAnalytics.getInstance();
val bundle = Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
analytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM, bundle);

אחרי (באמצעות ספריית קטקס במקום)

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

כל המוצרים Firebase מציעים הספרייה קטקס למעט Firebase ML ו לסריקת אפליקציות.

אם אתה עדיין לא, לבדוק את מסמכי פניית API עבור ספריות קטקס.

מודולי תכונה והפצת תכונת Play

החל ממאי 2021 (Firebase BoM v28.0.0), ניתן להשתמש ב- Firebase Android SDKs במודולי תכונות דינמיות המותקנים בנפרד ממודול היישומים הבסיסיים שלך.

כדי לאפשר תמיכה מודולים תכונה דינמית, להוסיף את התלות הבאה של מודול הבסיס שלך build.gradle קובץ:

dependencies {
  implementation 'com.google.firebase:firebase-dynamic-module-support:16.0.0-beta01'
}

כעת לאחר שהוספת תמיכה במודולים דינמיים, תוכל להוסיף תלות ב- SDK של Firebase (עם או בלי ה- Firebase BoM) כדי להציג מודולים של האפליקציה שלך ולהשתמש בהם כפי שהיית עושה בדרך כלל.

לדוגמה, אם היישום משתמש מסד זמן אמת לשלטון ספציפי בזמן אמת תכונה אתה יכול להוסיף את firebase-database התלות אל build.gradle של מודול התכונה ולא את מודול הבסיס. זה יקטין את גודל ההורדות עבור רוב המשתמשים.

שים לב להערות הבאות בעת שימוש ב- Firebase SDK במודולי תכונה:

  • מוצרים כגון Dynamic קישורים או Firebase In-App מסר אשר מסתמכים על Analytics first_open האירוע עלולים להחמיץ את האירוע הזה כאשר נעשה שימוש במודול תכונה דינמית.

  • כשאתה משתמש ב- Cloud Firestore ובאימות יחד, עליך תמיד לכלול את שניהם באותו מודול. אם זה לא אפשרי, אז לוודא כי האימות נטענת לפני קלאוד Firestore; אחרת, ייתכן שחלק מפעולות Cloud Firestore כוללות מצב אימות שגוי.

  • בעת שימוש firebase-crashlytics-ndk כתלות של מודול מאפיין דינמי, אתה צריך להגדיר את unstrippedNativeLibsDir רכוש של האפליקציה שלך build.gradle קובץ, כמתואר בתיעוד Crashlytics NDK .

לקבלת מידע נוסף על מודולים תכונה משלוח Feature Play, בקר סקירה של משלוח Feature Play .

שירותי Google תוסף Gradle לעומת שירותי Google Play לעומת חנות Google Play

למספר חלקים של המערכת האקולוגית של Google, Firebase ו- Android יש מוסכמות שמות דומות. להלן הסבר קצר לכל אחד:

תוסף Gradle לשירותי Google
Gradle תוסף ( com.google.gms.google-services ) כי פועל בשלב לבנות כדי להבטיח כי יש לאפליקציה בתצורת הזכות Firebase גישה ו- Google APIs
למרות שמו, לתוסף זה אין קשר לשירותי Google Play (ראה ערך הבא) ואין לו השפעה על יכולות האפליקציה שלך בזמן ריצה.
תוסף זה גם מעבד את google-services.json קובץ שתוסיף האפליקציה שלך כחלק בהקמת Firebase. למידע נוסף על תוסף Gradle שירותי גוגל .
שירותי Google Play
שירות רקע בלתי נראה הפועל במכשיר אנדרואיד ומספק מספר ממשקי API נפוצים של Google (כמו מפות Google ו- Google Sign In) לאפליקציות במכשיר
על ידי ריכוז ממשקי ה- API הנפוצים לשירות אחד, הוא מקטין את גודל האפליקציות האחרות ומאפשר למכשיר לקבל עדכוני אבטחה אוטומטיים ושיפורי תכונות ללא עדכון מערכת הפעלה. למידע נוסף על שירותי Google Play .
חנות הגוגל סטור
חנות להורדת אפליקציות, סרטים, ספרים ועוד במכשיר אנדרואיד
כמפתח, אתה מנהל את ההפצה, המהדורות וכו 'לאפליקציה שלך באמצעות מסוף Google Play. אם למכשיר יש את חנות Google Play, הוא פועל גם על שירותי Google Play (ראה ערך קודם). למידע נוסף על חנות Google Play עבור מפתחים .
שירותי Google Play משחקים
קבוצה של ממשקי API למפתחי משחקים ניידים
למידע נוסף על שירותי Google Play משחק ואיך לשלב Firebase עם Google Play המשחקים שלך שירותי הפרויקט .

משאבי קוד פתוח עבור Firebase Android SDKs

Firebase תומך בפיתוח קוד פתוח, ואנו מעודדים תרומות ומשוב של הקהילה.

Firebase Android SDKs

רוב Firebase אנדרואיד ערכות SDK מפותחים כמו ספריות קוד פתוח בציבור שלנו למאגר Firebase GitHub . אנו פועלים באופן פעיל להעביר בקרוב את שאר ספריות Firebase המפותחות באופן פרטי אל GitHub הציבורי שלנו!

דוגמאות להתחלה מהירה

Firebase שומר אוסף של דוגמאות התחלה מהירה עבור רוב ממשקי ה- Firebase ב- Android. מצא quickstarts אלה בפומבי שלנו למאגר QuickStart Firebase GitHub .

אתה יכול לפתוח כל התחלה מהירה כפרויקט של Android Studio ולאחר מכן להריץ במכשיר נייד או בהתקן וירטואלי (AVD). או שתוכל להשתמש בהתחלות המהירות האלה כקוד לדוגמא לשימוש ב- Firebase SDK.

נושאים מעניינים אחרים