דרישות מוקדמות
מתקינים או מעדכנים את Android Studio לגרסה האחרונה.
צריך לוודא שהפרויקט עומד בדרישות האלה (שימו לב: יכול להיות שלמוצרים מסוימים יש דרישות מחמירות יותר):
- מטרגטת לרמת API 23 (Marshmallow) ומעלה
- מכשיר Android מגרסה 6.0 ואילך
- האפליקציה משתמשת ב-Jetpack (AndroidX), שכולל את דרישות הגרסה הבאות:
-
com.android.tools.build:gradleגרסה 7.3.0 ואילך -
compileSdkVersion28 ואילך
-
מגדירים מכשיר פיזי או משתמשים באמולטור כדי להריץ את האפליקציה.
שימו לב: כדי להשתמש ב-Firebase SDKs עם תלות ב-Google Play Services, צריך להתקין את Google Play Services במכשיר או באמולטור.נכנסים ל-Firebase באמצעות חשבון Google.
אם עדיין אין לכם פרויקט Android ואתם רק רוצים לנסות מוצר של Firebase, אתם יכולים להוריד אחת מדוגמאות ההפעלה המהירה שלנו.
אפשר לקשר את אפליקציית Android ל-Firebase באחת מהדרכים הבאות:
- אפשרות 1: (מומלץ) שימוש בתהליך ההגדרה במסוף Firebase.
- אפשרות 2: שימוש ב-Firebase Assistant ב-Android Studio (יכול להיות שתידרש הגדרה נוספת).
אפשרות 1: הוספת Firebase באמצעות מסוף Firebase
הוספת Firebase לאפליקציה כוללת משימות במסוף Firebase ובפרויקט Android הפתוח (לדוגמה, מורידים קובצי תצורה של Firebase מהמסוף, ואז מעבירים אותם לפרויקט Android).
שלב 1: יצירת פרויקט Firebase
לפני שמוסיפים את Firebase לאפליקציית Android, צריך ליצור פרויקט Firebase כדי לקשר אותו לאפליקציית Android. במאמר הסבר על פרויקטים ב-Firebase יש מידע נוסף על פרויקטים ב-Firebase.
שלב 2: רישום האפליקציה ב-Firebase
כדי להשתמש ב-Firebase באפליקציית Android, צריך לרשום את האפליקציה בפרויקט Firebase. רישום האפליקציה נקרא לעיתים קרובות "הוספה" של האפליקציה לפרויקט.
עוברים אל מסוף Firebase.
במרכז הדף 'סקירת הפרויקט', לוחצים על הסמל Android () או על הוספת אפליקציה כדי להפעיל את תהליך ההגדרה.
מזינים את שם החבילה של האפליקציה בשדה שם החבילה של Android.
(אופציונלי) מזינים כינוי לאפליקציה, שהוא מזהה פנימי שנועד לנוחותכם ומוצג רק לכם במסוף Firebase.
לוחצים על רישום האפליקציה.
שלב 3: מוסיפים קובץ הגדרה של Firebase
מורידים את קובץ התצורה של Firebase של האפליקציה (
) ומוסיפים אותו לבסיס הקוד:google-services.json לוחצים על הורדת google-services.json כדי לקבל את קובץ התצורה של Firebase של האפליקציה.
מעבירים את קובץ ההגדרות לתיקיית השורש של המודול (ברמת האפליקציה) של האפליקציה.
כדי שערכות ה-SDK של Firebase יוכלו לגשת לערכים בקובץ ההגדרות
, צריך את התוסף Google services 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.4" 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.4' 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: מוסיפים את Firebase SDKs לאפליקציה
בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל
<project>/<app-module>/build.gradle.ktsאו<project>/<app-module>/build.gradle), מוסיפים את יחסי התלות של מוצרי Firebase שרוצים להשתמש בהם באפליקציה. מומלץ להשתמש ב-Firebase Android BoM כדי לשלוט בניהול הגרסאות של הספרייה.Analytics הופעלו
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:34.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.
Analytics לא מופעל
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:34.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.
אחרי שמוסיפים את יחסי התלות של המוצרים שרוצים להשתמש בהם, מסנכרנים את פרויקט Android עם קובצי Gradle.
זהו זה! אפשר לדלג קדימה כדי לעיין בשלבים הבאים המומלצים.
אם נתקלתם בבעיות בהגדרה, מומלץ לעיין בשאלות הנפוצות ובפתרון הבעיות ב-Android.
אפשרות 2: הוספת Firebase באמצעות Firebase Assistant
העוזר של Firebase רושם את האפליקציה שלכם בפרויקט Firebase ומוסיף את הקבצים, הפלאגינים והתלויות הדרושים של Firebase לפרויקט Android – והכול מתוך Android Studio!
פותחים את פרויקט Android ב-Android Studio ומוודאים שמשתמשים בגרסאות העדכניות של Android Studio ושל Firebase Assistant:
- Windows / Linux: עזרה > בדיקה אם יש עדכונים
- macOS: Android Studio > Check for updates (בדיקת עדכונים)
פותחים את Firebase Assistant: כלים > Firebase.
בחלונית העזרה, בוחרים מוצר של Firebase להוספה לאפליקציה. מרחיבים את הקטע שלו ולוחצים על הקישור למדריך (לדוגמה,
Analytics > תיעוד אירוע Analytics ).לוחצים על Connect to Firebase (קישור ל-Firebase) כדי לקשר את פרויקט Android ל-Firebase.
לוחצים על הלחצן כדי להוסיף את מוצר Firebase הרצוי (לדוגמה,
הוספת Analytics לאפליקציה ).
מסנכרנים את האפליקציה כדי לוודא שלכל הרכיבים התלויים יש את הגרסאות הנדרשות.
בחלונית העוזר, פועלים לפי שאר הוראות ההגדרה של מוצר Firebase שבחרתם.
אפשר להוסיף כמה מוצרי Firebase שרוצים באמצעות Firebase Assistant.
זהו זה! חשוב לעיין בשלבים הבאים המומלצים.
אם נתקלתם בבעיות בהגדרה, מומלץ לעיין בשאלות הנפוצות ובפתרון הבעיות ב-Android.
ספריות זמינות
בקטע הזה מפורטים מוצרי Firebase שנתמכים ב-Android והתלות שלהם ב-Gradle. מידע נוסף על ספריות Firebase Android האלה:
Firebase Android SDK מאגר GitHub
הערה: כשמשתמשים ב-Firebase Android BoM, לא מציינים גרסאות ספציפיות של ספריות כשמצהירים על תלות בספריות Firebase בקובץ ההגדרות של Gradle.
| שירות או מוצר | תלות ב-Gradle | הגרסה העדכנית |
להוסיף את Analytics? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Firebase Android BoM (Bill of Materials) |
com.google.firebase:firebase-bom
גרסה Firebase BoM כוללת את הגרסאות העדכניות ביותר של כל ספריית Firebase Android. כדי לדעת אילו גרסאות של הספרייה ממופות לגרסה ספציפית של BoM, אפשר לעיין בהערות לגבי הגרסה של BoM. |
34.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| AdMob | com.google.android.gms:play-services-ads | 24.8.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic 1 | com.google.firebase:firebase-ai | 17.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Analytics | com.google.firebase:firebase-analytics | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check ספק בהתאמה אישית | com.google.firebase:firebase-appcheck | 19.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check ספק ניפוי באגים | com.google.firebase:firebase-appcheck-debug | 19.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check ספק Play Integrity | com.google.firebase:firebase-appcheck-playintegrity | 19.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution | com.google.firebase:firebase-appdistribution | 16.0.0-beta17 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution API | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta17 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution פלאגין | com.google.firebase:firebase-appdistribution-gradle | 5.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Authentication | com.google.firebase:firebase-auth | 24.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Firestore | com.google.firebase:firebase-firestore | 26.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions | 22.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Messaging | com.google.firebase:firebase-messaging | 25.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Storage | com.google.firebase:firebase-storage | 22.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics | com.google.firebase:firebase-crashlytics | 20.0.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 20.0.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics פלאגין | com.google.firebase:firebase-crashlytics-gradle | 3.0.6 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Data Connect | com.google.firebase:firebase-dataconnect | 17.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| תמיכה במודולים של תכונות דינמיות | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta04 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging | com.google.firebase:firebase-inappmessaging | 22.0.2 | (חובה) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging רשת המדיה | com.google.firebase:firebase-inappmessaging-display | 22.0.2 | (חובה) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase התקנות | com.google.firebase:firebase-installations | 19.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase ML Model Downloader API | com.google.firebase:firebase-ml-modeldownloader | 26.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoring | com.google.firebase:firebase-perf | 22.0.4 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoring פלאגין | com.google.firebase:perf-plugin | 2.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase Phone Number Verification | com.google.firebase:firebase-pnv | 16.0.0-beta01 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Realtime Database | com.google.firebase:firebase-database | 22.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Remote Config | com.google.firebase:firebase-config | 23.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Google Play services plugin | com.google.gms:google-services | 4.4.4 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ספריות שהוצאו משימוש או שלא נתמכות | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Indexing | com.google.firebase:firebase-appindexing | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dynamic Links | com.google.firebase:firebase-dynamic-links | 22.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
מודולים של Firebase KTX – אין יותר תמיכה
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
ספריות Firebase ML Kit
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1 Firebase AI Logic נקרא בעבר
'Vertex AI in Firebase' עם החבילה
com.google.firebase:firebase-vertexai.
השלבים הבאים
מוסיפים שירותי Firebase לאפליקציה:
פיתוח תכונות מבוססות-AI גנרטיבי באמצעות מודלים של Gemini ו-Imagen באמצעות Firebase AI Logic.
קבלת תובנות לגבי התנהגות המשתמשים באמצעות Analytics.
מגדירים תהליך אימות משתמש באמצעות Authentication.
אחסון נתונים, כמו פרטי משתמשים, באמצעות Cloud Firestore או Realtime Database.
אחסון קבצים, כמו תמונות וסרטונים, באמצעות Cloud Storage.
הפעלת קוד backend שפועל בסביבה מאובטחת באמצעות Cloud Functions.
שליחת התראות באמצעות Cloud Messaging.
כדי לגלות מתי ולמה האפליקציה קורסת, אפשר להשתמש ב-Crashlytics.
מידע על Firebase
במאמר הסבר על פרויקטים ב-Firebase אפשר לקרוא מידע נוסף על פרויקטים ב-Firebase ועל שיטות מומלצות לניהול פרויקטים.
אם יש לכם שאלות לגבי מושגים לא מוכרים או מושגים שספציפיים ל-Firebase ולפיתוח ל-Android, תוכלו לעיין במאמר מידע נוסף על Android ו-Firebase.
כדאי להתנסות ב-Firebase Android Codelab.
אפשר לקרוא מידע נוסף בקורס Firebase in a Weekend.
הכנות להשקת האפליקציה:
- מגדירים התראות על תקציב לפרויקט במסוף Google Cloud.
- כדי לקבל תמונה כוללת של השימוש בפרויקט בשירותי Firebase שונים, אפשר לעקוב אחרי לוח הבקרה 'שימוש וחיוב' במסוף Firebase.
- עיון ברשימת המשימות להשקה של Firebase.
נתקלתם בבעיות ב-Firebase ובפרויקט Android? כדאי לעיין בשאלות הנפוצות ובפתרון הבעיות ב-Android.