Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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

    • מטרות API ברמה 16 (Jelly Bean) ומעלה
    • משתמש באנדרואיד 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. הוסף את קובץ התצורה של Firebase Android לאפליקציה שלך:

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

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

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

    1. בשנת ברמת השורש שלך (פרויקט ברמה) קובץ Gradle ( build.gradle ), להוסיף כללים לכלול את תוסף Gradle שירותי Google. בדוק שיש לך גם את מאגר Maven של Google.

      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.10'  // 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 ).

    Analytics מופעל

    ג'אווה

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

    קוטלין+KTX

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

    Analytics אינו מופעל

    ג'אווה

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.4.2')
    
      // 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.4.2')
    
      // 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!

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

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



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

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

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

ג'אווה

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

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

28.4.2
AdMob com.google.android.gms: play-services-ads 20.4.0
ניתוח com.google.firebase: firebase-analytics 19.0.2
ספק יישום מותאם אישית com.google.firebase: firebase-appcheck 16.0.0-beta03
ספק באגים לאפליקציות com.google.firebase: firebase-appcheck-debug 16.0.0-beta03
ספק יישום SafetyNet com.google.firebase: firebase-appcheck-safetynet 16.0.0-beta03
תוסף הפצת אפליקציות com.google.firebase: firebase-appdistribution-gradle 2.2.0
אינדקס אפליקציות com.google.firebase: אינדקס האפליקציות של firebase 20.0.0
אימות com.google.firebase: firebase-auth 21.0.1
Cloud Firestore com.google.firebase: firebase-firestore 23.0.4
פונקציות ענן עבור Firebase Client SDK com.google.firebase: פונקציות firebase 20.0.1
העברת הודעות בענן com.google.firebase: הודעות basebase 22.0.0
אחסון בענן com.google.firebase: אחסון בסיס 20.0.0
התרסקות com.google.firebase: firebase-crashlytics 18.2.3
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.3
תוסף Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
תמיכה במודול תכונות דינמיות com.google.firebase: תמיכה ב- firebase-dynamic-module-module 16.0.0-beta01
קישורים דינמיים com.google.firebase: firebase-dynamic-links 20.1.1
הודעות בתוך האפליקציה com.google.firebase: שליחת הודעות בבסיס האש 20.1.0
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase: firebase-inappmessaging-display 20.1.0
(נדרש)
התקנות Firebase com.google.firebase: התקנות בסיס 17.0.0
ממשק API להורדת מודלים של Firebase ML com.google.firebase: firebase-ml-modeldownloader 24.0.0
ניטור ביצועים com.google.firebase: firebase-perf 20.0.3
תוסף לניטור ביצועים com.google.firebase: תוסף perf 1.4.0
מסד נתונים בזמן אמת com.google.firebase: מסד נתונים של firebase 20.0.2
תצורה מרחוק com.google.firebase: firebase-config 21.0.1
תוסף שירותי Google Play com.google.gms: google-services 4.3.10
ספריות שהוצאו משימוש
ממשקי API של דגם מותאם אישית של Firebase ML com.google.firebase: מתרגם firebase-ml-model 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: תרגם מודל com.google.firebase: firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: דגם תגובה חכמה com.google.firebase: firebase-ml-natural-language-smart-model-reply-model 20.0.8

קוטלין+KTX

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

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

28.4.2
AdMob com.google.android.gms: play-services-ads 20.4.0
ניתוח com.google.firebase: firebase-analytics-ktx 19.0.2
ספק יישום מותאם אישית com.google.firebase: firebase-appcheck 16.0.0-beta03
ספק באגים לאפליקציות com.google.firebase: firebase-appcheck-debug 16.0.0-beta03
ספק יישום SafetyNet com.google.firebase: firebase-appcheck-safetynet 16.0.0-beta03
תוסף הפצת אפליקציות com.google.firebase: firebase-appdistribution-gradle 2.2.0
אינדקס אפליקציות com.google.firebase: אינדקס האפליקציות של firebase 20.0.0
אימות com.google.firebase: firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase: firebase-firestore-ktx 23.0.4
פונקציות ענן עבור Firebase Client SDK com.google.firebase: firebase-functions-ktx 20.0.1
העברת הודעות בענן 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.3
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.3
תוסף Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
תמיכה במודול תכונות דינמיות com.google.firebase: תמיכה ב- firebase-dynamic-module-module 16.0.0-beta01
קישורים דינמיים com.google.firebase: firebase-dynamic-links-ktx 20.1.1
הודעות בתוך האפליקציה com.google.firebase: firebase-inappmessaging-ktx 20.1.0
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase: firebase-inappmessaging-display-ktx 20.1.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.3
תוסף לניטור ביצועים com.google.firebase: תוסף perf 1.4.0
מסד נתונים בזמן אמת com.google.firebase: firebase-database-ktx 20.0.2
תצורה מרחוק com.google.firebase: firebase-config-ktx 21.0.1
תוסף שירותי Google Play com.google.gms: google-services 4.3.10
ספריות שהוצאו משימוש
ממשקי API של דגם מותאם אישית של Firebase ML com.google.firebase: מתרגם firebase-ml-model 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: תרגם מודל com.google.firebase: firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: דגם תגובה חכמה com.google.firebase: firebase-ml-natural-language-smart-model-reply-model 20.0.8



הצעדים הבאים

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

למד על Firebase: