获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

הוסף את 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 ( google-services.json ) לאפליקציה שלך:

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

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

  2. כדי להפוך את הערכים בקובץ התצורה google-services.json שלך לנגישים ל-SDK של Firebase, אתה צריך את הפלאגין של שירותי Google Gradle ( google-services ).

    1. בקובץ Gradle ברמת השורש (ברמת הפרויקט) ( <project>/build.gradle ), הוסף את הפלאגין של שירותי Google כתלות ב-buildscript:

      buildscript {
      
          repositories {
            // Make sure that you have the following two repositories
            google()  // Google's Maven repository
            mavenCentral()  // Maven Central repository
          }
      
          dependencies {
            ...
      
            // Add the dependency for the Google services Gradle plugin
            classpath 'com.google.gms:google-services:4.3.14'
          }
      }
      
      allprojects {
        ...
      
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
      }
      
    2. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle ), הוסף את הפלאגין של שירותי Google:

      plugins {
          id 'com.android.application'
      
          // Add the Google services Gradle plugin
          id 'com.google.gms.google-services'
          ...
      }
      

שלב 4 : הוסף ערכות SDK של Firebase לאפליקציה שלך

  1. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle ), הוסף את התלות של מוצרי Firebase שבהם ברצונך להשתמש באפליקציה שלך. אנו ממליצים להשתמש ב- Firebase Android BoM כדי לשלוט בגירסאות של הספרייה.

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

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:31.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // TODO: Add the dependencies for any other Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add 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:31.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // TODO: Add the dependencies for any other Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add 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:31.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // TODO: Add the dependencies for Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add 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:31.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // TODO: Add the dependencies for Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add 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. לאחר הוספת התלות של המוצרים שבהם ברצונך להשתמש, סנכרן את פרויקט האנדרואיד שלך עם קבצי Gradle.

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

אם אתה מתקשה להתקין, בקר בדף פתרון הבעיות והשאלות הנפוצות של 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.

31.1.0
AdMob com.google.android.gms:play-services-ads 21.3.0
ניתוח com.google.firebase:firebase-analytics 21.2.0
ספק בדיקת אפליקציה מותאם אישית com.google.firebase:firebase-appcheck 16.1.0
ספק ניפוי באגים של בדיקת אפליקציה com.google.firebase:firebase-appcheck-debug 16.1.0
ספק שלמות האפליקציה Check Play com.google.firebase:firebase-appcheck-playintegrity 16.1.0
ספק SafetyNet של בדיקת אפליקציה com.google.firebase:firebase-appcheck-safetynet 16.1.0
הפצת אפליקציות com.google.firebase:firebase-appdistribution 16.0.0-beta05
API להפצת אפליקציות com.google.firebase:firebase-appdistribution-api 16.0.0-beta05
תוסף הפצת אפליקציות com.google.firebase:firebase-appdistribution-gradle 3.1.1
אימות com.google.firebase:firebase-auth 21.1.0
Cloud Firestore com.google.firebase:firebase-firestore 24.4.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 20.2.1
העברת הודעות בענן com.google.firebase:firebase-messaging 23.1.0
אחסון בענן com.google.firebase:firebase-storage 20.1.0
Crashlytics com.google.firebase:firebase-crashlytics 18.3.2
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.2
תוסף Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
תמיכה במודול תכונה דינמית com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
קישורים דינמיים com.google.firebase:firebase-dynamic-links 21.1.0
העברת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging 20.2.0
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-display 20.2.0
(נדרש)
התקנות Firebase com.google.firebase:firebase-installations 17.1.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 24.1.1
ניטור ביצועים com.google.firebase:firebase-perf 20.3.0
תוסף ניטור ביצועים com.google.firebase:perf-plugin 1.4.2
מסד נתונים בזמן אמת com.google.firebase:firebase-database 20.1.0
תצורה מרחוק com.google.firebase:firebase-config 21.2.0
תוסף שירותי Google Play com.google.gms:google-services 4.3.14
ספריות שהוצאו משימוש
הוספת אפליקציות לאינדקס 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.

31.1.0
AdMob com.google.android.gms:play-services-ads 21.3.0
ניתוח com.google.firebase:firebase-analytics-ktx 21.2.0
ספק בדיקת אפליקציה מותאם אישית com.google.firebase:firebase-appcheck-ktx 16.1.0
ספק ניפוי באגים של בדיקת אפליקציה com.google.firebase:firebase-appcheck-debug 16.1.0
ספק SafetyNet של בדיקת אפליקציה com.google.firebase:firebase-appcheck-safetynet 16.1.0
API להפצת אפליקציות com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta05
תוסף הפצת אפליקציות com.google.firebase:firebase-appdistribution-gradle 3.1.1
אימות com.google.firebase:firebase-auth-ktx 21.1.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.4.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.2.1
העברת הודעות בענן com.google.firebase:firebase-messaging-ktx 23.1.0
אחסון בענן com.google.firebase:firebase-storage-ktx 20.1.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.3.2
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.2
תוסף Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
תמיכה במודול תכונה דינמית com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
קישורים דינמיים com.google.firebase:firebase-dynamic-links-ktx 21.1.0
העברת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-ktx 20.2.0
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-display-ktx 20.2.0
(נדרש)
התקנות Firebase com.google.firebase:firebase-installations-ktx 17.1.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 24.1.1
ניטור ביצועים com.google.firebase:firebase-perf-ktx 20.3.0
תוסף ניטור ביצועים com.google.firebase:perf-plugin 1.4.2
מסד נתונים בזמן אמת com.google.firebase:firebase-database-ktx 20.1.0
תצורה מרחוק com.google.firebase:firebase-config-ktx 21.2.0
תוסף שירותי Google Play com.google.gms:google-services 4.3.14
ספריות שהוצאו משימוש
הוספת אפליקציות לאינדקס 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 לאפליקציה שלך:

למד על Firebase: