Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now

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

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

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


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

  • אפשרות 1 : (מומלץ) השתמש בזרימת העבודה של הגדרת מסוף Firebase.
  • אפשרות 2 : השתמש ב- Android Studio Firebase Assistant (עשוי לדרוש תצורה נוספת).



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

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

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

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

שלב 2 : רשום את האפליקציה שלך ב- Firebase

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    ניתוח מופעל

    ג'אווה

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

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

    ג'אווה

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.0.1')
    
      // 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.0.1')
    
      // 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 , היישום שלך ישתמש תמיד בגרסאות תואמות של ספריות Android ל- Firebase.

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

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

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



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

ה- Firebase Assistant רושם את האפליקציה שלך בפרויקט Firebase ומוסיף את קבצי Firebase, התוספים והתלות הדרושים לפרויקט האנדרואיד שלך - הכל מתוך 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:

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

ג'אווה

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

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

28.0.1
AdMob com.google.android.gms: play-services-ads 20.1.0
ניתוח com.google.firebase: firebase-analytics 19.0.0
תוסף להפצת אפליקציות com.google.firebase: firebase-appdistribution-gradle 2.1.2
יצירת אינדקס לאפליקציות com.google.firebase: firebase-appindexing 20.0.0
אימות com.google.firebase: firebase-auth 21.0.1
ענן Firestore com.google.firebase: firebase-firestore 23.0.0
פונקציות ענן עבור 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.0.0
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.0.0
תוסף Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.6.1
תמיכה במודול תכונות דינמיות com.google.firebase: firebase-module-support-module 16.0.0-beta01
קישורים דינמיים com.google.firebase: קישורי firebase-dynamic 20.0.0
הודעות בתוך האפליקציה 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.0
תוסף לניטור ביצועים com.google.firebase: תוסף perf 1.4.0
מסד נתונים בזמן אמת com.google.firebase: מסד נתונים firebase 20.0.0
תצורה מרחוק 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-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.0.1
AdMob com.google.android.gms: play-services-ads 20.1.0
ניתוח com.google.firebase: firebase-analytics-ktx 19.0.0
תוסף להפצת אפליקציות com.google.firebase: firebase-appdistribution-gradle 2.1.2
יצירת אינדקס לאפליקציות 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.0
פונקציות ענן עבור 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.0.0
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.0.0
תוסף Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.6.1
תמיכה במודול תכונות דינמיות com.google.firebase: firebase-dynamic-module-support 16.0.0-beta01
קישורים דינמיים com.google.firebase: firebase-dynamic-links-ktx 20.0.0
הודעות בתוך האפליקציה 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.0
תוסף לניטור ביצועים com.google.firebase: תוסף perf 1.4.0
מסד נתונים בזמן אמת com.google.firebase: firebase-database-ktx 20.0.0
תצורה מרחוק 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: