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

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

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

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

  • מכוון ל- API ברמה 16 (Jelly Bean) ואילך
  • משתמש ב- Gradle 4.1 ואילך
  • משתמש ב- Jetpack (AndroidX) , הכולל עמידה בדרישות הגרסאות הבאות:
    • com.android.tools.build:gradle v3.2.1 ואילך
    • compileSdkVersion 28 ואילך

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

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

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

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

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

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

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

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

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

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

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

   1. בקובץ build.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.5'  // 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. באמצעות Android BoM של Firebase , הצהירו על התלות עבור מוצרי Firebase שבהם תרצו להשתמש באפליקציה שלכם. הכריז עליהם בקובץ app/build.gradle (ברמת האפליקציה) שלך במודול (בדרך כלל app/build.gradle ).

   ניתוח מופעל

   ג'אווה

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

   Kotlin + KTX

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

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

   ג'אווה

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

   Kotlin + KTX

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

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

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

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

עוזר Firebase רושם את האפליקציה שלך בפרויקט Firebase ומוסיף את קבצי Firebase, התוספים והתלות הדרושים לפרויקט האנדרואיד שלך - הכל מתוך Android Studio!

1. פתח את פרויקט Android שלך ב- Android Studio וגש לעוזר Firebase:

   1. עבור אל קובץ> בדוק אם קיימים עדכונים כדי לוודא שאתה משתמש בגירסאות העדכניות ביותר של Android Studio ו- Firebase Assistant.

   2. עבור אל כלים> Firebase כדי לפתוח את חלונית ה- Assistant .

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

   1. לחץ על התחבר ל- Firebase כדי לחבר את פרויקט Android שלך ל- Firebase.

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

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

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

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

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

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

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

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

4. בחלונית Assistant Firebase, פעל לפי הוראות ההתקנה הנותרות עבור מוצר Firebase שבחרת.

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

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

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

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

• תיעוד הפניה ( Java | Kotlin + KTX )

• Firebase Android SDK GitHub repo

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

הצעדים הבאים

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

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

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

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

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

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

• שלח התראות באמצעות Cloud Messaging .

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

למד אודות Firebase:

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

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

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

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

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

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

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