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

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

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

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

  • ממקד לרמת API 19 (KitKat) ומעלה
  • משתמש ב-Android 4.4 ומעלה
  • משתמש ב-Jetpack (AndroidX) , הכולל עמידה בדרישות הגרסה הבאות:
    • com.android.tools.build:gradle v7.3.0 ואילך
    • compileSdkVersion 28 ואילך

• הגדר מכשיר פיזי או השתמש באמולטור כדי להפעיל את האפליקציה שלך.
  שים לב ש- SDK של Firebase עם תלות בשירותי Google Play דורשים שהמכשיר או האמולטור יותקנו בשירותי 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. במרכז דף סקירת הפרויקט, לחץ על סמל אנדרואיד ( plat_android ) או הוסף אפליקציה כדי להפעיל את זרימת העבודה של ההגדרה.

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

   מהו שם חבילה, והיכן מוצאים אותו?

   • שם חבילה מזהה באופן ייחודי את האפליקציה שלך במכשיר ובחנות Google Play.

   • שם חבילה מכונה לעתים קרובות מזהה יישום .

   • מצא את שם החבילה של האפליקציה שלך בקובץ Gradle של המודול (ברמת האפליקציה), בדרך כלל app/build.gradle (שם חבילה לדוגמה: com.yourcompany.yourproject ).

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

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

   כיצד משתמשים בכינוי האפליקציה ובאישור החתימה על ניפוי באגים SHA-1 בתוך Firebase?

   • כינוי אפליקציה : מזהה פנימי, נוחות גלוי רק לך במסוף Firebase

   • ניפוי באגים באישור החתימה SHA-1 : יש צורך ב- hash של SHA-1 על ידי אימות Firebase (בעת שימוש ב- Google Sign In או כניסה למספר טלפון ) ו- Firebase Dynamic Links .

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

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

1. הורד ולאחר מכן הוסף את קובץ התצורה של Firebase Android ( google-services.json ) לאפליקציה שלך:

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

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

   מה אתה צריך לדעת על קובץ התצורה הזה?

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

   • תוכל להוריד שוב את קובץ התצורה של Firebase בכל עת.

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

2. כדי להפוך את הערכים בקובץ התצורה google-services.json שלך לנגישים ל-SDK של Firebase, אתה צריך את הפלאגין של שירותי Google Gradle ( google-services ).

   1. בקובץ Gradle ברמת השורש (ברמת הפרויקט) ( <project>/build.gradle.kts או <project>/build.gradle ), הוסף את הפלאגין של שירותי Google כתלות:

      Kotlin

      plugins {
        id("com.android.application") version "7.3.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.4.0" apply false
      }
      

      Groovy

      plugins {
        id 'com.android.application' version '7.3.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.4.0' apply false
      }
      

   2. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle ), הוסף את הפלאגין של שירותי Google:

      Kotlin

      plugins {
        id("com.android.application")
      
        // Add the Google services Gradle plugin
        id("com.google.gms.google-services")
        // ...
      }
      

      Groovy

      plugins {
        id 'com.android.application'
      
        // Add the Google services Gradle plugin
        id 'com.google.gms.google-services'
        // ...
      }
      

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

1. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle ), הוסף את התלות של מוצרי Firebase שבו אתה רוצה להשתמש באפליקציה שלך. אנו ממליצים להשתמש ב- Firebase Android BoM כדי לשלוט בגירסאות של הספרייה.

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

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.6.0"))
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Add the dependency for the Firebase SDK for Google Analytics
     implementation("com.google.firebase:firebase-analytics")
   
     // TODO: Add the dependencies for any other Firebase products you want to use
     // See https://firebase.google.com/docs/android/setup#available-libraries
     // For example, add the dependencies for Firebase Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth")
     implementation("com.google.firebase:firebase-firestore")
   }
   

   באמצעות Firebase Android BoM , האפליקציה שלך תמיד תשתמש בגרסאות תואמות של ספריות Firebase Android.

   מחפש מודול ספרייה ספציפי לקוטלין? החל מאוקטובר 2023 (Firebase BoM 32.5.0) , מפתחי Kotlin ו-Java יכולים להיות תלויים במודול הספרייה הראשי (לפרטים, עיין בשאלות הנפוצות לגבי יוזמה זו ).

   Analytics לא מופעל

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.6.0"))
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // TODO: Add the dependencies for Firebase products you want to use
     // See https://firebase.google.com/docs/android/setup#available-libraries
     // For example, add the dependencies for Firebase Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth")
     implementation("com.google.firebase:firebase-firestore")
   }
   

   באמצעות Firebase Android BoM , האפליקציה שלך תמיד תשתמש בגרסאות תואמות של ספריות Firebase Android.

   מחפש מודול ספרייה ספציפי לקוטלין? החל מאוקטובר 2023 (Firebase BoM 32.5.0) , מפתחי Kotlin ו-Java יכולים להיות תלויים במודול הספרייה הראשי (לפרטים, עיין בשאלות הנפוצות לגבי יוזמה זו ).

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

   האם אתה מקבל כשל בבנייה בנוגע לתמיכה בהתאמה אישית ולאפשר ביטול סוכר? הנה איך לתקן את זה.

   בניית Gradle המשתמשת ב-Android Gradle plugin (AGP) גרסה 4.2 או מוקדמת יותר צריכה לאפשר תמיכה ב-Java 8. אחרת, פרויקטי Android אלה מקבלים כשל בבנייה בעת הוספת Firebase SDK.

   כדי לתקן את כשל הבנייה הזה, תוכל לבצע אחת משתי אפשרויות:

   • הוסף את compileOptions המפורטים מהודעת השגיאה לקובץ build.gradle.kts או build.gradle ברמת האפליקציה .
   • הגדל את minSdk עבור פרויקט האנדרואיד שלך ל-26 ומעלה.

   למידע נוסף על כשל בנייה זה בשאלות נפוצות זה .

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

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

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

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

      מה עושה זרימת העבודה הזו?

      • זרימת עבודה זו יוצרת באופן אוטומטי אפליקציית Firebase Android חדשה באמצעות שם החבילה של האפליקציה שלך. אתה יכול ליצור את אפליקציית Firebase החדשה הזו ל-Android בפרויקט Firebase קיים או בפרויקט חדש.

        הנה כמה טיפים להגדרת פרויקט Firebase שלך:

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

        • אם אתה יוצר פרויקט חדש, אנו ממליצים בחום להגדיר את Google Analytics עבור הפרויקט שלך, המאפשר לך לקבל חוויה מיטבית בשימוש במוצרי Firebase רבים.

      • זרימת עבודה זו מוסיפה גם את קובץ התצורה של פרויקט ה-Android של פרויקט Firebase שלך ​​( google-services.json ) לספריית המודול (ברמת האפליקציה) של האפליקציה שלך.

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

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

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

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

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

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

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

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

• תיעוד עזר ( Kotlin+KTX | Java )

• Repo GitHub של Firebase Android SDK

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

הצעדים הבאים

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

• קבל תובנות על התנהגות המשתמשים עם Analytics .

• הגדר זרימת אימות משתמש באמצעות אימות .

• אחסן נתונים, כמו מידע משתמש, עם Cloud Firestore או Realtime Database .

• אחסן קבצים, כמו תמונות וסרטונים, עם Cloud Storage .

• הפעל קוד אחורי שפועל בסביבה מאובטחת עם פונקציות ענן .

• שלח הודעות עם הודעות ענן .

• גלה מתי ומדוע האפליקציה שלך קורסת עם Crashlytics .

למד על Firebase:

• בקר בהבנת פרויקטים של Firebase כדי ללמוד עוד על פרויקטים של Firebase ושיטות עבודה מומלצות לפרויקטים.

• בקר במידע נוסף על Android ו-Firebase אם יש לך שאלות על מושגים שאינם מוכרים או ספציפיים לפיתוח Firebase ו-Android.

• גלה אפליקציות Firebase לדוגמה .

• קבל חוויה מעשית עם Firebase Android Codelab .

• למד עוד עם קורס Firebase בסופשבוע .

• היכונו להפעלת האפליקציה שלכם:

  • הגדר התראות תקציב עבור הפרויקט שלך ב-Google Cloud Console.
  • עקוב אחר לוח המחוונים של השימוש והחיובים במסוף Firebase כדי לקבל תמונה כוללת של השימוש בפרויקט שלך בשירותי Firebase מרובים.
  • עיין ברשימת המשימות להפעלת Firebase .

• נתקלת בבעיות עם Firebase ופרויקט האנדרואיד שלך? בקר בדף פתרון הבעיות והשאלות הנפוצות של Android .