Google is committed to advancing racial equity for Black communities. See how.
דף זה תורגם על ידי Cloud Translation API.
Switch to English

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

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

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

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

    • מכוון ל- API ברמה 16 (Jelly Bean) ואילך
    • משתמש ב- Gradle 4.1 ואילך
    • משתמש ב- Jetpack (AndroidX) , הכולל עמידה בדרישות הגרסאות הבאות:
      • com.android.tools.build:gradle v3.2.1 ואילך
      • compileSdkVersion 28 ואילך
  • הגדר מכשיר פיזי או השתמש באמולטור להפעלת האפליקציה שלך.
    שים לב שב- SDK של Firebase עם תלות בשירותי 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. הוסף את קובץ התצורה של Android ל- Firebase לאפליקציה שלך:

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

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

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

    1. בקובץ build.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.5'  // 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. באמצעות Android BoM של Firebase , הצהירו על התלות עבור מוצרי Firebase שבהם תרצו להשתמש באפליקציה שלכם. הכריז עליהם בקובץ app/build.gradle (ברמת האפליקציה) שלך במודול (בדרך כלל app/build.gradle ).

    ניתוח מופעל

    ג'אווה

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

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

    ג'אווה

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

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

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



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

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

  1. פתח את פרויקט Android שלך ב- Android Studio וגש לעוזר Firebase:

    1. עבור אל קובץ> בדוק אם קיימים עדכונים כדי לוודא שאתה משתמש בגירסאות העדכניות ביותר של Android Studio ו- Firebase Assistant.

    2. עבור אל כלים> Firebase כדי לפתוח את חלונית ה- Assistant .

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

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

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

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

  4. בחלונית Assistant Firebase, פעל לפי הוראות ההתקנה הנותרות עבור מוצר Firebase שבחרת.

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

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



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

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

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

ג'אווה

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

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

27.0.0
AdMob com.google.android.gms: play-services-ads 20.0.0
ניתוח com.google.firebase: firebase-analytics 18.0.3
יצירת אינדקס לאפליקציות com.google.firebase: firebase-appindexing 19.2.0
אימות com.google.firebase: firebase-auth 20.0.4
ענן Firestore com.google.firebase: firebase-firestore 22.1.2
פונקציות ענן עבור SDK לקוח Firebase com.google.firebase: פונקציות firebase 19.2.0
הודעות בענן com.google.firebase: הודעות firebase 21.1.0
אחסון בענן com.google.firebase: אחסון firebase 19.2.2
קריסלטים com.google.firebase: firebase-crashlytics 17.4.1
קישורים דינמיים com.google.firebase: firebase-dynamic-links 19.1.1
ממשק API להורדת דגם Firebase ML com.google.firebase: firebase-ml-modeldownloader 23.0.0
הודעות בתוך האפליקציה com.google.firebase: firebase-inappmessaging 19.1.5
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase: תצוגת firebase-inappmessaging 19.1.5
(נדרש)
ניטור ביצועים com.google.firebase: firebase-perf 19.1.1
מסד נתונים בזמן אמת com.google.firebase: מסד נתונים firebase 19.7.0
תצורה מרחוק com.google.firebase: firebase-config 20.0.4
תוסף שירותי Google Play com.google.gms: google-services 4.3.5
ספריות שהוצאו משימוש
ממשקי 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: ממשק API של Vision Edge של AutoML 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.

27.0.0
AdMob com.google.android.gms: play-services-ads 20.0.0
ניתוח com.google.firebase: firebase-analytics-ktx 18.0.3
יצירת אינדקס לאפליקציות com.google.firebase: firebase-appindexing 19.2.0
אימות com.google.firebase: firebase-auth-ktx 20.0.4
ענן Firestore com.google.firebase: firebase-firestore-ktx 22.1.2
פונקציות ענן עבור SDK של לקוח Firebase com.google.firebase: firebase-functions-ktx 19.2.0
הודעות בענן com.google.firebase: firebase-messaging-ktx 21.0.1
אחסון בענן com.google.firebase: firebase-storage-ktx 19.2.2
קריסלטיקים com.google.firebase: firebase-crashlytics-ktx 17.4.1
קישורים דינמיים com.google.firebase: firebase-dynamic-links-ktx 19.1.1
הודעות בתוך האפליקציה com.google.firebase: firebase-inappmessaging-ktx 19.1.5
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase: firebase-inappmessaging-display-ktx 19.1.5
(נדרש)
ניטור ביצועים com.google.firebase: firebase-perf-ktx 19.1.1
מסד נתונים בזמן אמת com.google.firebase: firebase-database-ktx 19.7.0
תצורה מרחוק com.google.firebase: firebase-config-ktx 20.0.4
תוסף שירותי Google Play com.google.gms: google-services 4.3.5
ספריות שהוצאו משימוש
ממשקי 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: ממשק API של Vision Edge של AutoML 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: