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

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

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

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

  • ממקד לרמת API 19 (KitKat) ומעלה
  • משתמש ב-Android 4.4 ומעלה
  • משתמש ב-Jetpack (AndroidX) , הכולל עמידה בדרישות הגרסה הבאות:
    • com.android.tools.build:gradle v3.2.1 ואילך
    • 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.

צור פרויקט Firebase

1. במסוף Firebase , לחץ על הוסף פרויקט .

   • כדי להוסיף משאבי Firebase לפרויקט Google Cloud קיים , הזן את שם הפרויקט שלו או בחר אותו מהתפריט הנפתח.

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

2. אם תתבקש, עיין בתנאי Firebase וקבל אותם.

3. לחץ על המשך .

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

   Firebase Crashlytics תחזיות Firebase

   Firebase Cloud Messaging הודעות באפליקציה של Firebase

   תצורה מרחוק של Firebase בדיקת A/B של Firebase

   בחר חשבון Google Analytics קיים או כדי ליצור חשבון חדש.

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

5. לחץ על צור פרויקט (או הוסף Firebase , אם אתה משתמש בפרויקט קיים של Google Cloud).

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

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

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

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

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

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

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

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

   1. בקובץ Gradle ברמת השורש (ברמת הפרויקט) ( build.gradle ), הוסף כללים שיכללו את הפלאגין של שירותי Google Gradle. בדוק שיש לך גם את מאגר 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 ), החל את הפלאגין של 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. באמצעות Firebase Android BoM , הכריז על התלות של מוצרי Firebase שבהם ברצונך להשתמש באפליקציה שלך. הכריז עליהם בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל app/build.gradle ).

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

   Java

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

   Analytics לא מופעל

   Java

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

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

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

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

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

   • הוסף את ה- compileOptions המפורטים מהודעת השגיאה לקובץ build.gradle שלך ברמת האפליקציה.
   • הגדל את minSdkVersion עבור פרויקט האנדרואיד שלך ל-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 שלך:

        • בקר ב- Understand Firebase Projects כדי ללמוד עוד על שיטות עבודה מומלצות ושיקולים להוספת אפליקציות לפרויקט 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:

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

• Repo GitHub של Firebase Android SDK

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

---

הצעדים הבאים

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

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

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

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

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

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

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

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

למד על Firebase:

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

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

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

• קבל ניסיון מעשי עם Firebase Android Codelab .

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

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

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

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