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

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

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

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

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

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

   • שים לב שערך שם החבילה תלוי באותיות רישיות, ולא ניתן לשנות אותו עבור אפליקציית Android זו של Firebase לאחר רישוםו בפרויקט 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. הוסף את קובץ התצורה של Firebase Android לאפליקציה שלך:

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

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

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

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

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

   • ודאו את שם קובץ config שלא הוסף עם דמויות נוספות, כמו (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. סנכרן את האפליקציה שלך כדי לוודא שלכל התלות יש את הגרסאות הדרושות.

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

   בניית Gradle שמשתמשת בתוסף Android Gradle (AGP) v4.2 ואילך צריכה לאפשר תמיכה ב- Java 8. אחרת, פרויקטים אלה של אנדרואיד מקבלים כשל בבנייה בעת הוספת 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 באמצעות האפליקציה שלכם שם חבילה . תוכל ליצור את אפליקציית האנדרואיד החדשה הזו של Firebase בפרויקט Firebase קיים או בפרויקט חדש.

        להלן מספר עצות לגבי הקמת פרויקט Firebase שלך:

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

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

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

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

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

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

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

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

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

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

קטע זה מפרט את מוצרי 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 ופרויקט האנדרואיד שלך? בקר פתרון בעיות אנדרואיד ושאלות נפוצות .