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

תנאים מוקדמים

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

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

    • מכוון ל- API ברמה 16 (Jelly Bean) ואילך
    • משתמש ב- Gradle 4.1 ואילך
    • שימושים Jetpack (AndroidX) , הכולל עמידה בדרישות הגירסה הבאות:
      • com.android.tools.build:gradle v3.2.1 או במאוחר
      • compileSdkVersion 28 או מאוחר יותר
  • הגדרת התקן פיזי או להשתמש אמולטור כדי להפעיל את האפליקציה.
    הערה כי Firebase SDKs עם תלות בשירותי Google Play דורש את המכשיר או אמולטור יש בשירותי Google Play המותקנים.

  • היכנס Firebase באמצעות חשבון Google שלך.

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


באפשרותך לחבר את אפליקציית Android שלך ל- Firebase באמצעות אחת מהאפשרויות הבאות:

  • אפשרות 1 : (מומלץ) השתמש עבודת התקנת קונסולת Firebase.
  • אפשרות 2 : השתמש עוזר Firebase סטודיו אנדרואיד (עשוי לדרוש תצורה נוספת).



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

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

שלב 1: יצירת פרויקט Firebase

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

שלב 2: רשמו את האפליקציה שלכם עם Firebase

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

  1. עבור אל קונסולת Firebase .

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

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

  4. (אופציונאלי) זן פרטי אפליקציה אחרים: כינוי App ו Debug חתימת אישור SHA-1.

  5. לחץ אפליקצית רישום.

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

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

    1. לחץ על google-services.json הורדה לקבל קובץ config Firebase Android שלך ( google-services.json ).

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

  2. כדי לאפשר מוצרי Firebase באפליקציה, להוסיף את שירותי Google תוסף לקבצי Gradle שלך.

    1. בשנת ברמת השורש שלך (פרויקט ברמה) קובץ Gradle ( build.gradle ), להוסיף כללים לכלול את תוסף Gradle שירותי Google. בדוק שיש לך גם מאגר 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.8'  // 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 ), להחיל את תוסף Gradle שירותי Google:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

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

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

    ניתוח מופעל

    ג'אווה

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.3.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:28.3.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 אנדרואיד BOM , האפליקציה שלך תמיד ישתמשו גירסאות תואמות של ספריות אנדרואיד Firebase.

    ניתוח לא מופעל

    ג'אווה

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.3.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:28.3.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 אנדרואיד BOM , האפליקציה שלך תמיד ישתמשו גירסאות תואמות של ספריות אנדרואיד Firebase.

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

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

אם אתה נתקל בקשיים בהגדרות, אם כי, בקר פתרון בעיות אנדרואיד ושאלות נפוצות .



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

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

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

    • Windows / Linux: עזרה> בדוק אם יש עדכונים
    • MacOS: סטודיו אנדרואיד> בדוק עדכונים
  2. פתח את עוזר Firebase: כלים> Firebase.

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

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

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

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

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

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

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

אם אתה נתקל בקשיים בהגדרות, אם כי, בקר פתרון בעיות אנדרואיד ושאלות נפוצות .



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

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

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

ג'אווה

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

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

28.3.0
AdMob com.google.android.gms: play-services-ads 20.2.0
ניתוח com.google.firebase: firebase-analytics 19.0.0
ספק יישום בדוק אפליקציות com.google.firebase: firebase-appcheck 16.0.0-beta02
ספק איתור באגים באפליקציות com.google.firebase: firebase-appcheck-debug 16.0.0-beta02
ספק CheckNet של אפליקציות com.google.firebase: firebase-appcheck-safetynet 16.0.0-beta02
תוסף להפצת אפליקציות com.google.firebase: firebase-appdistribution-gradle 2.1.3
יצירת אינדקס לאפליקציות com.google.firebase: firebase-appindexing 20.0.0
אימות com.google.firebase: firebase-auth 21.0.1
ענן Firestore com.google.firebase: firebase-firestore 23.0.3
פונקציות ענן עבור SDK של לקוח Firebase com.google.firebase: פונקציות firebase 20.0.0
מסרים בענן com.google.firebase: העברת הודעות firebase 22.0.0
אחסון בענן com.google.firebase: אחסון firebase 20.0.0
קריסלטיקים com.google.firebase: firebase-crashlytics 18.2.0
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.0
תוסף Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
תמיכה במודול תכונות דינמיות com.google.firebase: firebase-module-support-module 16.0.0-beta01
קישורים דינמיים com.google.firebase: קישורי firebase-dynamic 20.1.1
הודעות בתוך האפליקציה com.google.firebase: firebase-inappmessaging 20.0.0
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase: תצוגת firebase-inappmessaging-display 20.0.0
(נדרש)
התקנות Firebase com.google.firebase: התקנות firebase 17.0.0
ממשק API להורדת דגם Firebase ML com.google.firebase: firebase-ml-modeldownloader 24.0.0
ניטור ביצועים com.google.firebase: firebase-perf 20.0.2
תוסף לניטור ביצועים com.google.firebase: תוסף perf 1.4.0
מסד נתונים בזמן אמת com.google.firebase: מסד נתונים firebase 20.0.1
תצורה מרחוק com.google.firebase: firebase-config 21.0.0
תוסף שירותי Google Play com.google.gms: google-services 4.3.8
ספריות שהוצאו משימוש
ממשקי API למודל מותאם אישית של Firebase ML com.google.firebase: firebase-ml-model-tolk 22.0.4
ממשקי API לחזון Firebase ML 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-discovery-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-id-model 20.0.8
Firebase ML: דגם תרגום com.google.firebase: firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: מודל תשובה חכם 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. כדי ללמוד אילו גרסאות ספרייה ממופות לגרסת BoM ספציפית, עיין בהערות המהדורה של אותה גרסת BoM.

28.3.0
AdMob com.google.android.gms: play-services-ads 20.2.0
ניתוח com.google.firebase: firebase-analytics-ktx 19.0.0
ספק יישום בדוק אפליקציות com.google.firebase: firebase-appcheck 16.0.0-beta02
ספק איתור באגים באפליקציה com.google.firebase: firebase-appcheck-debug 16.0.0-beta02
ספק CheckNet של אפליקציות com.google.firebase: firebase-appcheck-safetynet 16.0.0-beta02
תוסף להפצת אפליקציות com.google.firebase: firebase-appdistribution-gradle 2.1.3
יצירת אינדקס לאפליקציות com.google.firebase: firebase-appindexing 20.0.0
אימות com.google.firebase: firebase-auth-ktx 21.0.1
ענן Firestore com.google.firebase: firebase-firestore-ktx 23.0.3
פונקציות ענן עבור SDK של לקוח Firebase com.google.firebase: firebase-functions-ktx 20.0.0
מסרים בענן com.google.firebase: firebase-messaging-ktx 22.0.0
אחסון בענן com.google.firebase: firebase-storage-ktx 20.0.0
קריסלטיקים com.google.firebase: firebase-crashlytics-ktx 18.2.0
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.0
תוסף Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
תמיכה במודול תכונות דינמיות com.google.firebase: firebase-module-support-module 16.0.0-beta01
קישורים דינמיים com.google.firebase: firebase-dynamic-links-ktx 20.1.1
הודעות בתוך האפליקציה com.google.firebase: firebase-inappmessaging-ktx 20.0.0
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase: firebase-inappmessaging-display-ktx 20.0.0
(נדרש)
התקנות Firebase com.google.firebase: firebase-installations-ktx 17.0.0
ממשק API להורדת דגם Firebase ML com.google.firebase: firebase-ml-modeldownloader-ktx 24.0.0
ניטור ביצועים com.google.firebase: firebase-perf-ktx 20.0.2
תוסף לניטור ביצועים com.google.firebase: תוסף perf 1.4.0
מסד נתונים בזמן אמת com.google.firebase: firebase-database-ktx 20.0.1
תצורה מרחוק com.google.firebase: firebase-config-ktx 21.0.0
תוסף שירותי Google Play com.google.gms: google-services 4.3.8
ספריות שהוצאו משימוש
ממשקי API למודל מותאם אישית של Firebase ML com.google.firebase: firebase-ml-model-tolk 22.0.4
ממשקי API לחזון Firebase ML 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-discovery-model-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-id-model 20.0.8
Firebase ML: דגם תרגום com.google.firebase: firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: מודל תשובה חכם com.google.firebase: firebase-ml-natural-language-smart-reply-model 20.0.8



הצעדים הבאים

הוסף שירותי Firebase לאפליקציה שלך:

למד אודות Firebase: