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

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

  • התקן או עדכן את Android Studio לגרסה האחרונה שלו.

  • ודא שהפרויקט שלך עומד בדרישות הבאות:

    • ממקד לרמת API 19 (KitKat) ומעלה
    • משתמש ב-Android 4.4 ומעלה
    • משתמש ב-Jetpack (AndroidX) , הכולל עמידה בדרישות הגרסה הבאות:
      • com.android.tools.build:gradle v7.3.0 ואילך
      • 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.kts או <project>/build.gradle ), הוסף את הפלאגין של שירותי Google כתלות:

      Kotlin

      plugins {
        id("com.android.application") version "7.3.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.4.0" apply false
      }
      

      Groovy

      plugins {
        id 'com.android.application' version '7.3.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.4.0' apply false
      }
      
    2. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle ), הוסף את הפלאגין של שירותי Google:

      Kotlin

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

      Groovy

      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.kts או <project>/<app-module>/build.gradle ), הוסף את התלות של מוצרי Firebase שבו אתה רוצה להשתמש באפליקציה שלך. אנו ממליצים להשתמש ב- Firebase Android BoM כדי לשלוט בגירסאות של הספרייה.

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

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

    באמצעות Firebase Android BoM , האפליקציה שלך תמיד תשתמש בגרסאות תואמות של ספריות Firebase Android.

    מחפש מודול ספרייה ספציפי לקוטלין? החל מאוקטובר 2023 (Firebase BoM 32.5.0) , מפתחי Kotlin ו-Java יכולים להיות תלויים במודול הספרייה הראשי (לפרטים, עיין בשאלות הנפוצות לגבי יוזמה זו ).

    Analytics לא מופעל

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

    באמצעות Firebase Android BoM , האפליקציה שלך תמיד תשתמש בגרסאות תואמות של ספריות Firebase Android.

    מחפש מודול ספרייה ספציפי לקוטלין? החל מאוקטובר 2023 (Firebase BoM 32.5.0) , מפתחי Kotlin ו-Java יכולים להיות תלויים במודול הספרייה הראשי (לפרטים, עיין בשאלות הנפוצות לגבי יוזמה זו ).

  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 בקובץ התצורה של בניית Gradle.

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

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

32.6.0
AdMob com.google.android.gms:play-services-ads 22.5.0
ניתוח com.google.firebase:firebase-analytics 21.5.0
ספק בדיקת אפליקציה מותאם אישית com.google.firebase:firebase-appcheck 17.1.1
ספק ניפוי באגים של בדיקת אפליקציה com.google.firebase:firebase-appcheck-debug 17.1.1
ספק שלמות האפליקציה Check Play com.google.firebase:firebase-appcheck-playintegrity 17.1.1
הפצת אפליקציות com.google.firebase:firebase-appdistribution 16.0.0-בטא11
API להפצת אפליקציות com.google.firebase:firebase-appdistribution-api 16.0.0-בטא11
תוסף הפצת אפליקציות com.google.firebase:firebase-appdistribution-gradle 4.0.1
אימות com.google.firebase:firebase-auth 22.3.0
Cloud Firestore com.google.firebase:firebase-firestore 24.9.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 20.4.0
העברת הודעות בענן com.google.firebase:firebase-messaging 23.3.1
אחסון בענן com.google.firebase:firebase-storage 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics 18.6.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.6.0
תוסף Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.9
תמיכה במודול תכונה דינמית com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
קישורים דינמיים com.google.firebase:firebase-dynamic-links 21.2.0
העברת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging 20.4.0
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-display 20.4.0
(נדרש)
התקנות Firebase com.google.firebase:firebase-installations 17.2.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 24.2.1
ניטור ביצועים com.google.firebase:firebase-perf 20.5.1
תוסף ניטור ביצועים com.google.firebase:perf-plugin 1.4.2
מסד נתונים בזמן אמת com.google.firebase:firebase-database 20.3.0
תצורה מרחוק com.google.firebase:firebase-config 21.6.0
תוסף שירותי Google Play com.google.gms:google-services 4.4.0
ספריות מיושנות
ספק SafetyNet של בדיקת אפליקציה com.google.firebase:firebase-appcheck-safetynet 16.1.2
הוספת אפליקציות לאינדקס com.google.firebase:firebase-appindexing 20.0.0

מודולי Firebase KTX

ניתוח com.google.firebase:firebase-analytics-ktx 21.5.0
ספק בדיקת אפליקציה מותאם אישית com.google.firebase:firebase-appcheck-ktx 17.1.1
API להפצת אפליקציות com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-בטא11
אימות com.google.firebase:firebase-auth-ktx 22.3.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.9.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.4.0
העברת הודעות בענן com.google.firebase:firebase-messaging-ktx 23.3.1
אחסון בענן com.google.firebase:firebase-storage-ktx 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.6.0
קישורים דינמיים com.google.firebase:firebase-dynamic-links-ktx 21.2.0
העברת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-ktx 20.4.0
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-display-ktx 20.4.0
(נדרש)
התקנות Firebase com.google.firebase:firebase-installations-ktx 17.2.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 24.2.1
ניטור ביצועים com.google.firebase:firebase-perf-ktx 20.5.1
מסד נתונים בזמן אמת com.google.firebase:firebase-database-ktx 20.3.0
תצורה מרחוק com.google.firebase:firebase-config-ktx 21.6.0

ספריות Firebase ML Kit

ממשקי 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: