דרישות מוקדמות
התקן או עדכן את 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 שלך. רישום האפליקציה שלך נקרא לעתים קרובות "הוספת" האפליקציה שלך לפרויקט שלך.
עבור אל מסוף Firebase .
במרכז דף סקירת הפרויקט, לחץ על סמל אנדרואיד (
) או הוסף אפליקציה כדי להפעיל את זרימת העבודה של ההגדרה.הזן את שם החבילה של האפליקציה שלך בשדה שם החבילה של Android .
שם חבילה מזהה באופן ייחודי את האפליקציה שלך במכשיר ובחנות Google Play.
שם חבילה מכונה לעתים קרובות מזהה יישום .
מצא את שם החבילה של האפליקציה שלך בקובץ Gradle של המודול (ברמת האפליקציה), בדרך כלל
app/build.gradle
(שם חבילה לדוגמה:com.yourcompany.yourproject
).שים לב שערך שם החבילה הוא תלוי רישיות, ולא ניתן לשנות אותו עבור אפליקציית Firebase Android זו לאחר שהיא נרשמה בפרויקט Firebase שלך.
(אופציונלי) הזן מידע אחר על האפליקציה: כינוי לאפליקציה ואישור חתימת באגים SHA-1 .
כינוי אפליקציה : מזהה פנימי, נוחות גלוי רק לך במסוף Firebase
ניפוי באגים באישור החתימה SHA-1 : יש צורך ב- hash של SHA-1 על ידי אימות Firebase (בעת שימוש ב- Google Sign In או כניסה למספר טלפון ) ו- Firebase Dynamic Links .
לחץ על הרשמה אפליקציה .
שלב 3 : הוסף קובץ תצורה של Firebase
הורד ולאחר מכן הוסף את קובץ התצורה של Firebase Android (
) לאפליקציה שלך:google-services.json לחץ על הורד את google-services.json כדי להשיג את קובץ התצורה של Firebase Android שלך.
העבר את קובץ התצורה שלך לספריית השורש של המודול (ברמת האפליקציה) של האפליקציה שלך.
קובץ התצורה של Firebase מכיל מזהים ייחודיים, אך לא סודיים עבור הפרויקט שלך. למידע נוסף על קובץ תצורה זה, בקר ב- Understand Firebase Projects .
תוכל להוריד שוב את קובץ התצורה של Firebase בכל עת.
ודא ששם קובץ התצורה אינו מצורף עם תווים נוספים, כמו
(2)
.
כדי להפוך את הערכים בקובץ התצורה
שלך לנגישים ל-SDK של Firebase, אתה צריך את הפלאגין של שירותי Google Gradle (google-services.json google-services
).בקובץ 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 }
בקובץ 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 לאפליקציה שלך
בקובץ 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 יכולים להיות תלויים במודול הספרייה הראשי (לפרטים, עיין בשאלות הנפוצות לגבי יוזמה זו ).
לאחר הוספת התלות של המוצרים שבהם ברצונך להשתמש, סנכרן את פרויקט האנדרואיד שלך עם קבצי 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!
פתח את פרויקט ה-Android שלך ב-Android Studio, ולאחר מכן ודא שאתה משתמש בגרסאות האחרונות של Android Studio וב-Firebase Assistant:
- Windows / Linux: עזרה > בדוק אם קיימים עדכונים
- macOS: Android Studio > בדוק אם קיימים עדכונים
פתח את Firebase Assistant: כלים > Firebase .
בחלונית Assistant , בחר מוצר של Firebase להוספה לאפליקציה שלך. הרחב את הקטע שלו ולאחר מכן לחץ על הקישור למדריך (לדוגמה,
Analytics > רישום אירוע ב-Analytics ).לחץ על התחבר ל-Firebase כדי לחבר את פרויקט ה-Android שלך ל-Firebase.
זרימת עבודה זו יוצרת באופן אוטומטי אפליקציית Firebase Android חדשה באמצעות שם החבילה של האפליקציה שלך. אתה יכול ליצור את אפליקציית Firebase החדשה הזו ל-Android בפרויקט Firebase קיים או בפרויקט חדש.
הנה כמה טיפים להגדרת פרויקט Firebase שלך:
בדוק את השיטות המומלצות שלנו להוספת אפליקציות לפרויקט Firebase, כולל איך לטפל במגוון וריאציות.
אם אתה יוצר פרויקט חדש, אנו ממליצים בחום להגדיר את Google Analytics עבור הפרויקט שלך, המאפשר לך לקבל חוויה מיטבית בשימוש במוצרי Firebase רבים.
זרימת עבודה זו מוסיפה גם את קובץ התצורה של פרויקט ה-Android של פרויקט Firebase שלך (
) לספריית המודול (ברמת האפליקציה) של האפליקציה שלך.google-services.json
לחץ על הלחצן כדי להוסיף מוצר Firebase רצוי (לדוגמה,
הוסף Analytics לאפליקציה שלך ).
סנכרן את האפליקציה שלך כדי להבטיח שלכל התלות יש את הגרסאות הדרושות.
בחלונית Assistant , עקוב אחר הוראות ההגדרה הנותרות עבור מוצר Firebase שבחרת.
הוסף כמה מוצרים אחרים של Firebase שתרצה באמצעות Firebase Assistant!
זהו זה! הקפד לבדוק את השלבים הבאים המומלצים.
אם אתה מתקשה להתקין, בקר בדף פתרון הבעיות והשאלות הנפוצות של Android .
ספריות זמינות
סעיף זה מפרט את מוצרי Firebase הנתמכים עבור Android ואת התלות שלהם ב-Gradle. למידע נוסף על ספריות Firebase Android אלה:
תיעוד עזר ( Kotlin+KTX | Java )
Repo GitHub של Firebase Android SDK
שים לב שכאשר אתה משתמש ב- Firebase Android BoM , אתה לא מציין גרסאות ספרייה בודדות כאשר אתה מצהיר על תלות בספריית Firebase בקובץ התצורה של בניית Gradle.
שירות או מוצר | תלות מדורגת | הכי מאוחר גִרְסָה | להוסיף אנליטיקס? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Firebase Android BoM (כתב חומרים) | com.google.firebase:firebase-bom הגרסה האחרונה של Firebase BoM מכילה את הגרסאות העדכניות ביותר של כל ספריית Firebase Android. כדי ללמוד אילו גרסאות ספרייה ממפות לגרסת BoM ספציפית, עיין בהערות הגרסה עבור אותה גרסת BoM. | 32.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AdMob | com.google.android.gms:play-services-ads | 22.5.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ניתוח | com.google.firebase:firebase-analytics | 21.5.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ספק בדיקת אפליקציה מותאם אישית | com.google.firebase:firebase-appcheck | 17.1.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ספק ניפוי באגים של בדיקת אפליקציה | com.google.firebase:firebase-appcheck-debug | 17.1.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ספק שלמות האפליקציה Check Play | com.google.firebase:firebase-appcheck-playintegrity | 17.1.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
הפצת אפליקציות | com.google.firebase:firebase-appdistribution | 16.0.0-בטא11 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
API להפצת אפליקציות | com.google.firebase:firebase-appdistribution-api | 16.0.0-בטא11 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
תוסף הפצת אפליקציות | com.google.firebase:firebase-appdistribution-gradle | 4.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
אימות | com.google.firebase:firebase-auth | 22.3.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Firestore | com.google.firebase:firebase-firestore | 24.9.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions | 20.4.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
העברת הודעות בענן | com.google.firebase:firebase-messaging | 23.3.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
אחסון בענן | com.google.firebase:firebase-storage | 20.3.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics | com.google.firebase:firebase-crashlytics | 18.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
תוסף Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.9 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
תמיכה במודול תכונה דינמית | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta03 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
קישורים דינמיים | com.google.firebase:firebase-dynamic-links | 21.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
העברת הודעות בתוך האפליקציה | com.google.firebase:firebase-inappmessaging | 20.4.0 | (נדרש) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
תצוגת הודעות בתוך האפליקציה | com.google.firebase:firebase-inappmessaging-display | 20.4.0 | (נדרש) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
התקנות Firebase | com.google.firebase:firebase-installations | 17.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Firebase ML Model Downloader API | com.google.firebase:firebase-ml-modeldownloader | 24.2.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ניטור ביצועים | com.google.firebase:firebase-perf | 20.5.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
תוסף ניטור ביצועים | com.google.firebase:perf-plugin | 1.4.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
מסד נתונים בזמן אמת | com.google.firebase:firebase-database | 20.3.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
תצורה מרחוק | com.google.firebase:firebase-config | 21.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
תוסף שירותי Google Play | com.google.gms:google-services | 4.4.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ספריות מיושנות | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ספק SafetyNet של בדיקת אפליקציה | com.google.firebase:firebase-appcheck-safetynet | 16.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
הוספת אפליקציות לאינדקס | com.google.firebase:firebase-appindexing | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
מודולי Firebase KTX
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ספריות Firebase ML Kit
|
הצעדים הבאים
הוסף שירותי Firebase לאפליקציה שלך:
קבל תובנות על התנהגות המשתמשים עם Analytics .
הגדר זרימת אימות משתמש באמצעות אימות .
אחסן נתונים, כמו מידע משתמש, עם Cloud Firestore או Realtime Database .
אחסן קבצים, כמו תמונות וסרטונים, עם Cloud Storage .
הפעל קוד אחורי שפועל בסביבה מאובטחת עם פונקציות ענן .
שלח הודעות עם הודעות ענן .
גלה מתי ומדוע האפליקציה שלך קורסת עם Crashlytics .
למד על Firebase:
בקר בהבנת פרויקטים של Firebase כדי ללמוד עוד על פרויקטים של Firebase ושיטות עבודה מומלצות לפרויקטים.
בקר במידע נוסף על Android ו-Firebase אם יש לך שאלות על מושגים שאינם מוכרים או ספציפיים לפיתוח Firebase ו-Android.
קבל חוויה מעשית עם Firebase Android Codelab .
למד עוד עם קורס Firebase בסופשבוע .
היכונו להפעלת האפליקציה שלכם:
- הגדר התראות תקציב עבור הפרויקט שלך ב-Google Cloud Console.
- עקוב אחר לוח המחוונים של השימוש והחיובים במסוף Firebase כדי לקבל תמונה כוללת של השימוש בפרויקט שלך בשירותי Firebase מרובים.
- עיין ברשימת המשימות להפעלת Firebase .
נתקלת בבעיות עם Firebase ופרויקט האנדרואיד שלך? בקר בדף פתרון הבעיות והשאלות הנפוצות של Android .