Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
דף זה תורגם על ידי Cloud Translation API.
Switch to English

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

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

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

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

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

פעל בהתאם להוראות בדף ההתחלה של Android כדי להשתמש ב- Firebase Assistant. וודא כי אתה משתמש בגרסאות העדכניות ביותר של Android Studio וגם של Firebase Assistant (עבור אל File> Check for updates ).

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

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

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

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

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

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

בקר בתיעוד של Android כדי ללמוד כיצד הפלאגין של שירותי Google וקובץ התצורה עובדים יחד.

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 Android BoM כדי להצהיר על תלות בקובץ app/build.gradle במודול שלך (ברמת האפליקציה) (בדרך כלל app/build.gradle ). בעת השימוש ב- BoM, אינך מציין גרסאות ספרייה בודדות בשורות התלות.

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

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

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

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

dependencies {
  // Import the BoM for the Firebase platform (learn more)
  implementation platform('com.google.firebase:firebase-bom:28.0.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);

אחרי (במקום זאת משתמשים בספריית KTX)

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 מציעים ספריית KTX למעט Firebase ML ואינדקס אפליקציות.

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

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

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

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

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

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

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

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

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

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

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

משאבי קוד פתוח עבור SDK של Android

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

Firkase אנדרואיד SDK

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

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

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

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

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