הוסף את Firebase לפרויקט Android שלך

דרישות מוקדמות

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

  1. עבור אל מסוף Firebase .

  2. במרכז דף סקירת הפרויקט, לחץ על סמל אנדרואיד ( ) או הוסף אפליקציה כדי להפעיל את זרימת העבודה של ההגדרה.

  3. הזן את שם החבילה של האפליקציה שלך בשדה שם החבילה של Android .

  4. (אופציונלי) הזן מידע אחר על האפליקציה: כינוי לאפליקציה ואישור חתימת באגים SHA-1 .

  5. לחץ על הרשמה אפליקציה .

שלב 3 : הוסף קובץ תצורה של Firebase

  1. הוסף את קובץ התצורה של Firebase Android לאפליקציה שלך:

    1. לחץ על הורד את google-services.json כדי להשיג את קובץ התצורה של Firebase Android שלך ( google-services.json ).

    2. העבר את קובץ התצורה שלך לספריית המודול (ברמת האפליקציה) של האפליקציה שלך.

  2. כדי להפעיל מוצרי Firebase באפליקציה שלך, הוסף את הפלאגין google-services לקבצי Gradle שלך.

    1. בקובץ 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
          // ...
        }
      }
      
    2. בקובץ 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 לאפליקציה שלך

  1. באמצעות Firebase Android BoM , הכריז על התלות של מוצרי Firebase שבהם ברצונך להשתמש באפליקציה שלך. הכריז עליהם בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל app/build.gradle ).

    אנליטיקס מופעל

    Java

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

    קוטלין+KTX

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

    קוטלין+KTX

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

  2. סנכרן את האפליקציה שלך כדי להבטיח שלכל התלות יש את הגרסאות הדרושות.

זהו זה! אתה יכול לדלג קדימה כדי לבדוק את השלבים הבאים המומלצים.

אם אתה מתקשה להתקין, בקר בדף פתרון הבעיות והשאלות הנפוצות של Android .



אפשרות 2 : הוסף את Firebase באמצעות Firebase Assistant

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

  1. פתח את פרויקט ה-Android שלך ב-Android Studio, ולאחר מכן ודא שאתה משתמש בגרסאות האחרונות של Android Studio וב-Firebase Assistant:

    • Windows / Linux: עזרה > בדוק אם קיימים עדכונים
    • macOS: Android Studio > בדוק אם קיימים עדכונים
  2. פתח את Firebase Assistant: כלים > Firebase .

  3. בחלונית Assistant , בחר מוצר של Firebase להוספה לאפליקציה שלך. הרחב את הקטע שלו ולאחר מכן לחץ על קישור המדריך (לדוגמה, Analytics > רישום אירוע ב-Analytics ).

    1. לחץ על התחבר ל-Firebase כדי לחבר את פרויקט ה-Android שלך ל-Firebase.

    2. לחץ על הלחצן כדי להוסיף מוצר Firebase רצוי (לדוגמה, הוסף Analytics לאפליקציה שלך ).

  4. סנכרן את האפליקציה שלך כדי להבטיח שלכל התלות יש את הגרסאות הדרושות.

  5. בחלונית Assistant , עקוב אחר הוראות ההגדרה הנותרות עבור מוצר Firebase שבחרת.

  6. הוסף כמה מוצרים אחרים של Firebase שתרצה באמצעות ה-Firebase Assistant!

זהו זה! הקפד לבדוק את השלבים הבאים המומלצים.

אם אתה מתקשה להתקין, בקר בדף פתרון הבעיות והשאלות הנפוצות של Android .



ספריות זמינות

סעיף זה מפרט את מוצרי Firebase הנתמכים עבור Android ואת התלות שלהם ב-Gradle. למידע נוסף על ספריות אלה של Firebase Android:

שים לב שכאשר אתה משתמש ב- Firebase Android BoM , אתה לא מציין גרסאות ספרייה בודדות כאשר אתה מכריז על תלות בספריית Firebase ב- build.gradle .

Java

שירות או מוצר תלות מדורגת הכי מאוחר
גִרְסָה
להוסיף אנליטיקס?
Firebase Android BoM
(כתב חומרים)
com.google.firebase:firebase-bom

הגרסה האחרונה של Firebase BoM מכילה את הגרסאות העדכניות ביותר של כל ספריית Firebase Android. כדי ללמוד אילו גרסאות ספרייה ממפות לגרסת BoM ספציפית, עיין בהערות הגרסה עבור אותה גרסת BoM.

29.0.4
AdMob com.google.android.gms:play-services-ads 20.5.0
ניתוח com.google.firebase:firebase-analytics 20.0.2
ספק מותאם אישית של בדיקת אפליקציה com.google.firebase:firebase-appcheck 16.0.0-beta04
ספק ניפוי באגים של בדיקת אפליקציה com.google.firebase:firebase-appcheck-debug 16.0.0-beta04
בדיקת האפליקציה ספק SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta04
תוסף הפצת אפליקציות com.google.firebase:firebase-appdistribution-gradle 3.0.0
הוספת אפליקציות לאינדקס com.google.firebase:firebase-appindexing 20.0.0
אימות com.google.firebase:firebase-auth 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore 24.0.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 20.0.1
העברת הודעות בענן com.google.firebase:firebase-messaging 23.0.0
אחסון בענן com.google.firebase:firebase-storage 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.2.7
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.7
תוסף Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.8.1
תמיכה במודול תכונה דינמית com.google.firebase:firebase-dynamic-module-support 16.0.0-ביתא01
קישורים דינמיים com.google.firebase:firebase-dynamic-links 21.0.0
העברת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging 20.1.1
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-display 20.1.1
(נדרש)
התקנות Firebase com.google.firebase:firebase-installations 17.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 24.0.1
ניטור ביצועים com.google.firebase:firebase-perf 20.0.4
תוסף ניטור ביצועים com.google.firebase:perf-plugin 1.4.1
מסד נתונים בזמן אמת com.google.firebase:firebase-database 20.0.3
תצורה מרחוק com.google.firebase:firebase-config 21.0.1
תוסף שירותי Google Play com.google.gms:google-services 4.3.10
ספריות שהוצאו משימוש
ממשקי 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

קוטלין+KTX

שירות או מוצר תלות מדורגת הכי מאוחר
גִרְסָה
להוסיף אנליטיקס?
Firebase Android BoM
(כתב חומרים)
com.google.firebase:firebase-bom

הגרסה האחרונה של Firebase BoM מכילה את הגרסאות העדכניות ביותר של כל ספריית Firebase Android. כדי ללמוד אילו גרסאות ספרייה ממפות לגרסת BoM ספציפית, עיין בהערות הגרסה עבור אותה גרסת BoM.

29.0.4
AdMob com.google.android.gms:play-services-ads 20.5.0
ניתוח com.google.firebase:firebase-analytics-ktx 20.0.2
ספק מותאם אישית של בדיקת אפליקציה com.google.firebase:firebase-appcheck 16.0.0-beta04
ספק ניפוי באגים של בדיקת אפליקציה com.google.firebase:firebase-appcheck-debug 16.0.0-beta04
בדיקת האפליקציה ספק SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta04
תוסף הפצת אפליקציות com.google.firebase:firebase-appdistribution-gradle 3.0.0
הוספת אפליקציות לאינדקס com.google.firebase:firebase-appindexing 20.0.0
אימות com.google.firebase:firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.0.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.0.1
העברת הודעות בענן com.google.firebase:firebase-messaging-ktx 23.0.0
אחסון בענן com.google.firebase:firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.7
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.7
תוסף Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.8.1
תמיכה במודול תכונה דינמית com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
קישורים דינמיים com.google.firebase:firebase-dynamic-links-ktx 21.0.0
העברת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-ktx 20.1.1
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-display-ktx 20.1.1
(נדרש)
התקנות Firebase com.google.firebase:firebase-installations-ktx 17.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.1
ניטור ביצועים com.google.firebase:firebase-perf-ktx 20.0.4
תוסף ניטור ביצועים com.google.firebase:perf-plugin 1.4.1
מסד נתונים בזמן אמת com.google.firebase:firebase-database-ktx 20.0.3
תצורה מרחוק com.google.firebase:firebase-config-ktx 21.0.1
תוסף שירותי Google Play com.google.gms:google-services 4.3.10
ספריות שהוצאו משימוש
ממשקי 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 לאפליקציה שלך:

למד על Firebase: