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

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

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

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

  • מכוון ל- API ברמה 16 (Jelly Bean) ואילך
  • משתמש ב- Gradle 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.

צור פרויקט Firebase

1. בשנות ה קונסולת Firebase , לחץ פרויקט הוסף ובחר או להזין שם פרויקט.

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

2. (אופציונלי) אם אתה יוצר פרויקט חדש, אתה יכול לערוך את הפרויקט מזהה.

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

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

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

   Firebase Crashlytics חיזוי Firebase

   הודעות ענן של Firebase הודעות בתוך האפליקציה של Firebase

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

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

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

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. (אופציונאלי) זן פרטי אפליקציה אחרים: כינוי App ו Debug חתימת אישור SHA-1.

   איך הם כינוי App ואת תעודת חתימת Debug SHA-1 המשמש בתוך Firebase?

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

   • SHA-1 תעודת החתימה Debug: A חשיש SHA-1 נדרש על ידי Firebase אימות (בעת שימוש גוגל כניסה או סימן מספר הטלפון ) לבין Firebase דינמי קישורים .

5. לחץ אפליקצית רישום.

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

1. הוסף את קובץ התצורה של Android ל- Firebase לאפליקציה שלך:

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

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

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

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

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

   • ודאו את שם קובץ config שלא הוסף עם דמויות נוספות, כמו (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.8'  // 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 ).

   ניתוח מופעל

   ג'אווה

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

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

   ג'אווה

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

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

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

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

   • מוסיפים את הרשומות compileOptions מן הודעת השגיאה כדי ברמת היישום שלך build.gradle קובץ.
   • הגבר את minSdkVersion עבור פרויקט Android שלך 26 ומעלה.

   למידע נוסף על כישלון זה לבנות ב FAQ זה .

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

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

---

אפשרות 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.

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

• תיעוד הפניה ( Java | Kotlin + קטקס )

• Firebase Android SDK ריפו GitHub

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

---

הצעדים הבאים

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

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

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

• אחסן נתונים, כמו פרטי המשתמש, עם ענן Firestore או מסד נתונים בזמן אמת .

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

• קוד backend טריגר כי רץ בסביבה מאובטחת עם פונקציות ענן .

• שלח התראות עם Cloud Messaging .

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

למד אודות Firebase:

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

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

• חקור אפליקציות Firebase מדגם .

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

• למידע נוסף עם Firebase בסוף השבוע כמובן.

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

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

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