דרישות מוקדמות
התקן או עדכן את Android Studio לגרסה האחרונה שלו.
ודא שהפרויקט שלך עומד בדרישות הבאות:
- ממקד לרמת API 19 (KitKat) ומעלה
- משתמש ב-Android 4.4 ומעלה
- משתמש ב-Jetpack (AndroidX) , הכולל עמידה בדרישות הגרסה הבאות:
-
com.android.tools.build:gradle
v3.2.1 ואילך -
compileSdkVersion
28 ואילך
-
הגדר מכשיר פיזי או השתמש באמולטור כדי להפעיל את האפליקציה שלך.
שים לב ש- SDK של Firebase עם תלות בשירותי Google Play דורשים שהמכשיר או האמולטור יהיו מותקנים של שירותי Google Play.היכנס ל-Firebase באמצעות חשבון Google שלך.
אם עדיין אין לך פרויקט אנדרואיד ורק רוצה לנסות מוצר של Firebase, תוכל להוריד את אחת מדוגמאות ההתחלה המהירה שלנו.
אתה יכול לחבר את אפליקציית Android שלך ל-Firebase באמצעות אחת מהאפשרויות הבאות:
- אפשרות 1 : (מומלץ) השתמש בזרימת העבודה של הגדרת מסוף Firebase.
- אפשרות 2 : השתמש ב-Android Studio Firebase Assistant (ייתכן שתדרוש תצורה נוספת).
אפשרות 1 : הוסף את Firebase באמצעות מסוף Firebase
הוספת Firebase לאפליקציה שלך כרוכה במשימות הן במסוף Firebase והן בפרויקט ה-Android הפתוח שלך (לדוגמה, אתה מוריד קובצי תצורה של Firebase מהמסוף, ואז מעביר אותם לפרויקט Android שלך).
שלב 1 : צור פרויקט Firebase
לפני שתוכל להוסיף את Firebase לאפליקציית Android שלך, עליך ליצור פרויקט Firebase כדי להתחבר לאפליקציית Android שלך. בקר בהבנת פרויקטים של Firebase כדי ללמוד עוד על פרויקטים של Firebase.
שלב 2 : רשום את האפליקציה שלך ב-Firebase
כדי להשתמש ב-Firebase באפליקציית Android שלך, עליך לרשום את האפליקציה שלך בפרויקט Firebase שלך. רישום האפליקציה שלך נקרא לעתים קרובות "הוספת" האפליקציה שלך לפרויקט שלך.
עבור אל מסוף Firebase .
במרכז דף סקירת הפרויקט, לחץ על סמל אנדרואיד (
) או הוסף אפליקציה כדי להפעיל את זרימת העבודה של ההגדרה.הזן את שם החבילה של האפליקציה שלך בשדה שם החבילה של Android .
שם חבילה מזהה באופן ייחודי את האפליקציה שלך במכשיר ובחנות Google Play.
שם חבילה מכונה לעתים קרובות מזהה יישום .
מצא את שם החבילה של האפליקציה שלך בקובץ Gradle של המודול (ברמת האפליקציה), בדרך כלל
app/build.gradle
(שם חבילה לדוגמה:com.yourcompany.yourproject
).שים לב שערך שם החבילה הוא תלוי רישיות, ולא ניתן לשנות אותו עבור אפליקציית Firebase Android זו לאחר שהיא נרשמה בפרויקט Firebase שלך.
(אופציונלי) הזן מידע אחר על האפליקציה: כינוי לאפליקציה ואישור חתימת באגים SHA-1 .
כינוי לאפליקציה : מזהה פנימי, נוחות גלוי רק לך במסוף Firebase
ניפוי באגים באישור החתימה SHA-1 : יש צורך ב- hash SHA-1 על ידי אימות Firebase (בעת שימוש ב-Google Sign In או כניסה למספר טלפון ) ו- Firebase Dynamic Links .
לחץ על הרשמה אפליקציה .
שלב 3 : הוסף קובץ תצורה של Firebase
הוסף את קובץ התצורה של Firebase Android לאפליקציה שלך:
לחץ על הורד את google-services.json כדי להשיג את קובץ התצורה של Firebase Android שלך (
).google-services.json העבר את קובץ התצורה שלך לספריית המודול (ברמת האפליקציה) של האפליקציה שלך.
קובץ התצורה של Firebase מכיל מזהים ייחודיים, אך לא סודיים עבור הפרויקט שלך. למידע נוסף על קובץ התצורה הזה, בקר ב- Understand Firebase Projects .
אתה יכול להוריד שוב את קובץ התצורה של Firebase בכל עת.
ודא ששם קובץ התצורה אינו מצורף עם תווים נוספים, כמו
(2)
.
כדי להפעיל מוצרי Firebase באפליקציה שלך, הוסף את הפלאגין google-services לקבצי Gradle שלך.
בקובץ Gradle ברמת השורש (ברמת הפרויקט) (
build.gradle
), הוסף כללים שיכללו את הפלאגין של שירותי Google Gradle. בדוק שיש לך גם את מאגר Maven של גוגל.buildscript { repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository } dependencies { // ... // Add the following line: classpath 'com.google.gms:google-services:4.3.10' // Google Services plugin } } allprojects { // ... repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }
בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל
app/build.gradle
), החל את הפלאגין של Google Services Gradle:apply plugin: 'com.android.application' // Add the following line: apply plugin: 'com.google.gms.google-services' // Google Services plugin android { // ... }
שלב 4 : הוסף ערכות SDK של Firebase לאפליקציה שלך
באמצעות Firebase Android BoM , הכריז על התלות של מוצרי Firebase שבהם ברצונך להשתמש באפליקציה שלך. הכריז עליהם בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל
app/build.gradle
).אנליטיקס מופעל
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.1.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics' // Declare the dependencies for any other desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.1.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics-ktx' // Declare the dependencies for any other desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
באמצעות Firebase Android BoM , האפליקציה שלך תמיד תשתמש בגרסאות תואמות של ספריות Firebase Android.
Analytics לא מופעל
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.1.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependencies for the desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.1.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependencies for the desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
באמצעות Firebase Android BoM , האפליקציה שלך תמיד תשתמש בגרסאות תואמות של ספריות Firebase Android.
סנכרן את האפליקציה שלך כדי להבטיח שלכל התלות יש את הגרסאות הדרושות.
גרדלי בנייה המשתמשים ב-Android Gradle plugin (AGP) גרסה 4.2 או מוקדמת יותר צריכים לאפשר תמיכה ב-Java 8. אחרת, פרויקטי Android אלה מקבלים כשל בבנייה בעת הוספת Firebase SDK.
כדי לתקן את כשל הבנייה הזה, תוכל לבצע אחת משתי אפשרויות:
- הוסף את ה-
compileOptions
המפורטים מהודעת השגיאה לקובץbuild.gradle
שלך ברמת האפליקציה. - הגדל את
minSdkVersion
עבור פרויקט האנדרואיד שלך ל-26 ומעלה.
למידע נוסף על כשל בנייה זה בשאלות נפוצות זה .
- הוסף את ה-
זהו זה! אתה יכול לדלג קדימה כדי לבדוק את השלבים הבאים המומלצים.
אם אתה מתקשה להתקין, בקר בדף פתרון הבעיות והשאלות הנפוצות של Android .
אפשרות 2 : הוסף את Firebase באמצעות Firebase Assistant
ה- Firebase Assistant רושם את האפליקציה שלך בפרויקט Firebase ומוסיף את הקבצים, הפלאגינים והתלות הנדרשים של Firebase לפרויקט Android שלך - הכל מתוך Android Studio!
פתח את פרויקט ה-Android שלך ב-Android Studio, ולאחר מכן ודא שאתה משתמש בגרסאות האחרונות של Android Studio וב-Firebase Assistant:
- Windows / Linux: עזרה > בדוק אם קיימים עדכונים
- macOS: Android Studio > בדוק אם קיימים עדכונים
פתח את Firebase Assistant: כלים > Firebase .
בחלונית Assistant , בחר מוצר של Firebase להוספה לאפליקציה שלך. הרחב את הקטע שלו ולאחר מכן לחץ על קישור המדריך (לדוגמה,
Analytics > רישום אירוע ב-Analytics ).לחץ על התחבר ל-Firebase כדי לחבר את פרויקט ה-Android שלך ל-Firebase.
זרימת עבודה זו יוצרת באופן אוטומטי אפליקציית Firebase Android חדשה באמצעות שם החבילה של האפליקציה שלך. אתה יכול ליצור את אפליקציית Firebase החדשה הזו ל-Android בפרויקט Firebase קיים או בפרויקט חדש.
הנה כמה טיפים להגדרת פרויקט Firebase שלך:
בדוק את השיטות המומלצות שלנו להוספת אפליקציות לפרויקט Firebase, כולל איך לטפל במגוון וריאציות.
אם אתה יוצר פרויקט חדש, אנו ממליצים בחום להגדיר את Google Analytics עבור הפרויקט שלך, המאפשר לך לקבל חוויה מיטבית בשימוש במוצרי Firebase רבים.
זרימת עבודה זו מוסיפה גם את קובץ התצורה של Android של פרויקט Firebase שלך (
) לספריית המודול (ברמת האפליקציה) של האפליקציה שלך.google-services.json
לחץ על הלחצן כדי להוסיף מוצר Firebase רצוי (לדוגמה,
הוסף Analytics לאפליקציה שלך ).
סנכרן את האפליקציה שלך כדי להבטיח שלכל התלות יש את הגרסאות הדרושות.
בחלונית Assistant , עקוב אחר הוראות ההגדרה הנותרות עבור מוצר Firebase שבחרת.
הוסף כמה מוצרים אחרים של Firebase שתרצה באמצעות ה-Firebase Assistant!
זהו זה! הקפד לבדוק את השלבים הבאים המומלצים.
אם אתה מתקשה להתקין, בקר בדף פתרון הבעיות והשאלות הנפוצות של Android .
ספריות זמינות
סעיף זה מפרט את מוצרי Firebase הנתמכים עבור Android ואת התלות שלהם ב-Gradle. למידע נוסף על ספריות אלה של Firebase Android:
תיעוד עזר ( Java | Kotlin+KTX )
Repo GitHub של Firebase Android SDK
שים לב שכאשר אתה משתמש ב- Firebase Android BoM , אתה לא מציין גרסאות ספרייה בודדות כאשר אתה מכריז על תלות בספריית Firebase ב- build.gradle
.
Java
שירות או מוצר | תלות מדורגת | הכי מאוחר גִרְסָה | להוסיף אנליטיקס? |
---|---|---|---|
Firebase Android BoM (כתב חומרים) | com.google.firebase:firebase-bom הגרסה האחרונה של Firebase BoM מכילה את הגרסאות העדכניות ביותר של כל ספריית Firebase Android. כדי ללמוד אילו גרסאות ספרייה ממפות לגרסת BoM ספציפית, עיין בהערות הגרסה עבור אותה גרסת BoM. | 30.1.0 | |
AdMob | com.google.android.gms:play-services-ads | 21.0.0 | |
ניתוח | com.google.firebase:firebase-analytics | 21.0.0 | |
ספק מותאם אישית של בדיקת אפליקציה | com.google.firebase:firebase-appcheck | 16.0.0 | |
ספק ניפוי באגים של בדיקת אפליקציה | com.google.firebase:firebase-appcheck-debug | 16.0.0 | |
ספק שלמות האפליקציה Check Play | com.google.firebase:firebase-appcheck-playintegrity | 16.0.0 | |
ספק בדיקת אפליקציה SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.0.0 | |
הפצת אפליקציות | com.google.firebase:firebase-appdistribution | 16.0.0-beta03 | |
API להפצת אפליקציות | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta03 | |
תוסף הפצת אפליקציות | com.google.firebase:firebase-appdistribution-gradle | 3.0.2 | |
אימות | com.google.firebase:firebase-auth | 21.0.5 | |
Cloud Firestore | com.google.firebase:firebase-firestore | 24.1.2 | |
Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions | 20.1.0 | |
העברת הודעות בענן | com.google.firebase:firebase-messaging | 23.0.5 | |
אחסון בענן | com.google.firebase:firebase-storage | 20.0.1 | |
Crashlytics | com.google.firebase:firebase-crashlytics | 18.2.11 | |
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.2.11 | |
תוסף Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.0 | |
תמיכה במודול תכונה דינמית | com.google.firebase:firebase-dynamic-module-support | 16.0.0-ביתא01 | |
קישורים דינמיים | com.google.firebase:firebase-dynamic-links | 21.0.1 | |
העברת הודעות בתוך האפליקציה | com.google.firebase:firebase-inappmessaging | 20.1.2 | (נדרש) |
תצוגת הודעות בתוך האפליקציה | com.google.firebase:firebase-inappmessaging-display | 20.1.2 | (נדרש) |
התקנות Firebase | com.google.firebase:firebase-installations | 17.0.1 | |
Firebase ML Model Downloader API | com.google.firebase:firebase-ml-modeldownloader | 24.0.3 | |
ניטור ביצועים | com.google.firebase:firebase-perf | 20.1.0 | |
תוסף ניטור ביצועים | com.google.firebase:perf-plugin | 1.4.1 | |
מסד נתונים בזמן אמת | com.google.firebase:firebase-database | 20.0.5 | |
תצורה מרחוק | com.google.firebase:firebase-config | 21.1.0 | |
תוסף שירותי Google Play | com.google.gms:google-services | 4.3.10 | |
ספריות שהוצאו משימוש | |||
הוספת אפליקציות לאינדקס | com.google.firebase:firebase-appindexing | 20.0.0 | |
ממשקי API של מודל מותאם אישית של Firebase ML | com.google.firebase:firebase-ml-model-interpreter | 22.0.4 | |
ממשקי API של Firebase ML Vision | com.google.firebase:firebase-ml-vision | 24.1.0 | |
Firebase ML: מודל תיוג תמונה | com.google.firebase:firebase-ml-vision-image-label-model | 20.0.2 | |
Firebase ML: מודל זיהוי ומעקב של אובייקטים | com.google.firebase:firebase-ml-vision-object-detection-model | 19.0.6 | |
Firebase ML: דגם זיהוי פנים | com.google.firebase:firebase-ml-vision-face-model | 20.0.2 | |
Firebase ML: דגם סריקת ברקוד | com.google.firebase:firebase-ml-vision-barcode-model | 16.1.2 | |
Firebase ML: AutoML Vision Edge API | com.google.firebase:firebase-ml-vision-automl | 18.0.6 | |
Firebase ML: ממשקי API של שפה טבעית | com.google.firebase:firebase-ml-natural-language | 22.0.1 | |
Firebase ML: מודל זיהוי שפה | com.google.firebase:firebase-ml-natural-language-language-id-model | 20.0.8 | |
Firebase ML: Translate Model | com.google.firebase:firebase-ml-natural-language-translate-model | 20.0.9 | |
Firebase ML: Smart Reply Model | com.google.firebase:firebase-ml-natural-language-smart-reply-model | 20.0.8 |
Kotlin+KTX
שירות או מוצר | תלות מדורגת | הכי מאוחר גִרְסָה | להוסיף אנליטיקס? |
---|---|---|---|
Firebase Android BoM (כתב חומרים) | com.google.firebase:firebase-bom הגרסה האחרונה של Firebase BoM מכילה את הגרסאות העדכניות ביותר של כל ספריית Firebase Android. כדי ללמוד אילו גרסאות ספרייה ממפות לגרסת BoM ספציפית, עיין בהערות הגרסה עבור אותה גרסת BoM. | 30.1.0 | |
AdMob | com.google.android.gms:play-services-ads | 21.0.0 | |
ניתוח | com.google.firebase:firebase-analytics-ktx | 21.0.0 | |
ספק מותאם אישית של בדיקת אפליקציה | com.google.firebase:firebase-appcheck | 16.0.0 | |
ספק ניפוי באגים של בדיקת אפליקציה | com.google.firebase:firebase-appcheck-debug | 16.0.0 | |
ספק בדיקת אפליקציה SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.0.0 | |
API להפצת אפליקציות | com.google.firebase:firebase-appdistribution-api-ktx | 16.0.0-beta03 | |
תוסף הפצת אפליקציות | com.google.firebase:firebase-appdistribution-gradle | 3.0.2 | |
אימות | com.google.firebase:firebase-auth-ktx | 21.0.5 | |
Cloud Firestore | com.google.firebase:firebase-firestore-ktx | 24.1.2 | |
Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions-ktx | 20.1.0 | |
העברת הודעות בענן | com.google.firebase:firebase-messaging-ktx | 23.0.5 | |
אחסון בענן | com.google.firebase:firebase-storage-ktx | 20.0.1 | |
Crashlytics | com.google.firebase:firebase-crashlytics-ktx | 18.2.11 | |
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.2.11 | |
תוסף Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.0 | |
תמיכה במודול תכונה דינמית | com.google.firebase:firebase-dynamic-module-support | 16.0.0-ביתא01 | |
קישורים דינמיים | com.google.firebase:firebase-dynamic-links-ktx | 21.0.1 | |
העברת הודעות בתוך האפליקציה | com.google.firebase:firebase-inappmessaging-ktx | 20.1.2 | (נדרש) |
תצוגת הודעות בתוך האפליקציה | com.google.firebase:firebase-inappmessaging-display-ktx | 20.1.2 | (נדרש) |
התקנות Firebase | com.google.firebase:firebase-installations-ktx | 17.0.1 | |
Firebase ML Model Downloader API | com.google.firebase:firebase-ml-modeldownloader-ktx | 24.0.3 | |
ניטור ביצועים | com.google.firebase:firebase-perf-ktx | 20.1.0 | |
תוסף ניטור ביצועים | com.google.firebase:perf-plugin | 1.4.1 | |
מסד נתונים בזמן אמת | com.google.firebase:firebase-database-ktx | 20.0.5 | |
תצורה מרחוק | com.google.firebase:firebase-config-ktx | 21.1.0 | |
תוסף שירותי Google Play | com.google.gms:google-services | 4.3.10 | |
ספריות שהוצאו משימוש | |||
הוספת אפליקציות לאינדקס | com.google.firebase:firebase-appindexing | 20.0.0 | |
ממשקי API של מודל מותאם אישית של Firebase ML | com.google.firebase:firebase-ml-model-interpreter | 22.0.4 | |
ממשקי API של Firebase ML Vision | com.google.firebase:firebase-ml-vision | 24.1.0 | |
Firebase ML: מודל תיוג תמונה | com.google.firebase:firebase-ml-vision-image-label-model | 20.0.2 | |
Firebase ML: מודל זיהוי ומעקב של אובייקטים | com.google.firebase:firebase-ml-vision-object-detection-model | 19.0.6 | |
Firebase ML: דגם זיהוי פנים | com.google.firebase:firebase-ml-vision-face-model | 20.0.2 | |
Firebase ML: דגם סריקת ברקוד | com.google.firebase:firebase-ml-vision-barcode-model | 16.1.2 | |
Firebase ML: AutoML Vision Edge API | com.google.firebase:firebase-ml-vision-automl | 18.0.6 | |
Firebase ML: ממשקי API של שפה טבעית | com.google.firebase:firebase-ml-natural-language | 22.0.1 | |
Firebase ML: מודל זיהוי שפה | com.google.firebase:firebase-ml-natural-language-language-id-model | 20.0.8 | |
Firebase ML: Translate Model | com.google.firebase:firebase-ml-natural-language-translate-model | 20.0.9 | |
Firebase ML: Smart Reply Model | com.google.firebase:firebase-ml-natural-language-smart-reply-model | 20.0.8 |
הצעדים הבאים
הוסף שירותי Firebase לאפליקציה שלך:
השג תובנות על התנהגות המשתמשים עם Analytics .
הגדר זרימת אימות משתמש באמצעות אימות .
אחסן נתונים, כמו מידע משתמש, עם Cloud Firestore או Realtime Database .
אחסן קבצים, כמו תמונות וסרטונים, עם Cloud Storage .
הפעל קוד אחורי שפועל בסביבה מאובטחת עם פונקציות ענן .
שלח הודעות עם הודעות ענן .
גלה מתי ומדוע האפליקציה שלך קורסת עם Crashlytics .
למד על Firebase:
בקר ב- Understand Firebase Projects כדי ללמוד עוד על פרויקטים של Firebase ושיטות עבודה מומלצות לפרויקטים.
בקר במידע נוסף על Android ו-Firebase אם יש לך שאלות על מושגים שאינם מוכרים או ספציפיים לפיתוח Firebase ו-Android.
קבל ניסיון מעשי עם Firebase Android Codelab .
למד עוד עם קורס Firebase בסופשבוע .
היכונו להפעלת האפליקציה שלכם:
- הגדר התראות תקציב עבור הפרויקט שלך ב-Google Cloud Console.
- עקוב אחר לוח המחוונים של השימוש והחיובים במסוף Firebase כדי לקבל תמונה כוללת של השימוש בפרויקט שלך בשירותי Firebase מרובים.
- עיין ברשימת המשימות להפעלת Firebase .
נתקלת בבעיות עם Firebase ופרויקט האנדרואיד שלך? בקר בדף פתרון הבעיות והשאלות הנפוצות של Android .