Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

    • ממקד לרמת API 19 (KitKat) ומעלה
    • משתמש ב-Android 4.4 ומעלה
    • שימושים 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 של גוגל.

      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 ).

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

    Java

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

    קוטלין+KTX

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

    Analytics לא מופעל

    Java

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

    קוטלין+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:29.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 אנדרואיד 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 Android:

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

Java

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

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

29.0.0
AdMob com.google.android.gms:play-services-ads 20.5.0
ניתוח com.google.firebase:firebase-analytics 20.0.0
ספק מותאם אישית של בדיקת אפליקציה 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-appindexing 20.0.0
אימות com.google.firebase:firebase-auth 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore 24.0.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 20.0.1
העברת הודעות בענן com.google.firebase:firebase-messaging 23.0.0
אחסון בענן com.google.firebase:firebase-storage 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.2.4
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.4
תוסף Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.8.0
תמיכה במודול תכונה דינמית com.google.firebase:firebase-dynamic-module-support 16.0.0-ביתא01
קישורים דינמיים com.google.firebase:firebase-dynamic-links 21.0.0
העברת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging 20.1.1
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-display 20.1.1
(נדרש)
התקנות Firebase com.google.firebase:firebase-installations 17.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 24.0.0
ניטור ביצועים com.google.firebase:firebase-perf 20.0.3
תוסף ניטור ביצועים com.google.firebase:perf-plugin 1.4.0
מסד נתונים בזמן אמת com.google.firebase:firebase-database 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-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

קוטלין+KTX

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

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

29.0.0
AdMob com.google.android.gms:play-services-ads 20.5.0
ניתוח com.google.firebase:firebase-analytics-ktx 20.0.0
ספק מותאם אישית של בדיקת אפליקציה 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-appindexing 20.0.0
אימות com.google.firebase:firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.0.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.0.1
העברת הודעות בענן com.google.firebase:firebase-messaging-ktx 23.0.0
אחסון בענן com.google.firebase:firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.4
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.4
תוסף Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.8.0
תמיכה במודול תכונה דינמית com.google.firebase:firebase-dynamic-module-support 16.0.0-ביתא01
קישורים דינמיים com.google.firebase:firebase-dynamic-links-ktx 21.0.0
העברת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-ktx 20.1.1
(נדרש)
תצוגת הודעות בתוך האפליקציה com.google.firebase:firebase-inappmessaging-display-ktx 20.1.1
(נדרש)
התקנות Firebase com.google.firebase:firebase-installations-ktx 17.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.0
ניטור ביצועים com.google.firebase:firebase-perf-ktx 20.0.3
תוסף ניטור ביצועים com.google.firebase:perf-plugin 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-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: