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

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

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

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

ה- Firebase Assistant הוא תוסף Android Studio הרושם את אפליקציית Android שלך בפרויקט 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 במקום.

שירותי גוגל - תוסף וקובץ תצורה

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

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

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

Firebase Android BoM (שטר חומרים)

Firebase Android BoM (Bill of Materials) מאפשר לך לנהל את כל גרסאות ספריית 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.3.0')

  // 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

ספריות הרחבות קוטלין (KTX)

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

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

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

  // 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 עבור ספריות קטקס.

מודולי תכונות ומשלוח תכונות הפעלה

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

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

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

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

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

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

  • Crashlytics לא יתפוס קריסות NDK בשימוש במודול תכונות דינמי.

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

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

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

שירותי גוגל תוסף 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 שירותי גוגל .
שירותי גוגל פליי
שירות רקע בלתי נראה הפועל במכשיר אנדרואיד ומספק מספר ממשקי API נפוצים של גוגל (כמו מפות גוגל וכניסה של גוגל) לאפליקציות במכשיר
על ידי ריכוזם של ממשקי ה- API הנפוצים הללו לשירות יחיד, הוא מצמצם את גודל האפליקציות האחרות ומאפשר למכשיר לקבל עדכוני אבטחה אוטומטיים ושיפור תכונות ללא עדכון מערכת הפעלה. למידע נוסף על שירותי Google Play .
חנות הגוגל סטור
חנות להורדת אפליקציות, סרטים, ספרים ועוד במכשיר אנדרואיד
כמפתח, אתה מנהל את ההפצה, המהדורות וכו 'עבור האפליקציה שלך באמצעות קונסולת Google Play. אם למכשיר יש את חנות Google Play, הוא פועל גם שירותי Google Play (ראה ערך קודם). למידע נוסף על חנות Google Play עבור מפתחים .
שירותי Google Play משחקים
סט ממשקי API למפתחי משחקים ניידים
למידע נוסף על שירותי Google Play משחקים ואיך לשלב Firebase עם Google Play משחקים שלך שירותי הפרויקט .

מקורות קוד פתוח עבור Firebase אנדרואיד SDK

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

Firkase אנדרואיד SDK

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

דוגמאות להפעלה מהירה

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

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

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