הוספת Firebase לאפליקציית Flutter


דרישות מוקדמות

אם עדיין אין לכם אפליקציית Flutter, תוכלו להשלים את תחילת העבודה: נסיעה לבדיקה כדי ליצור אפליקציית Flutter חדשה באמצעות הכלי המועדף עליכם לעריכה או סביבת הפיתוח המשולבת (IDE).

שלב 1: מתקינים את כלי שורת הפקודה הנדרשים

  1. אם עדיין לא עשיתם זאת, מתקינים את ה-CLI של Firebase.

  2. נכנסים ל-Firebase באמצעות חשבון Google. לשם כך, מריצים את הפקודה הבאה הפקודה:

    firebase login

  3. מתקינים את ה-CLI של FlutterFire על ידי הרצת הפקודה הבאה מכל ספרייה:

    dart pub global activate flutterfire_cli

שלב 2: מגדירים את האפליקציות לשימוש ב-Firebase

משתמשים ב-FlutterFire CLI כדי להגדיר את האפליקציות של Flutter להתחבר ל-Firebase.

מספריית הפרויקט של Flutter, מריצים את הפקודה הבאה כדי להפעיל את תהליך עבודה של הגדרת אפליקציה:

flutterfire configure


שלב 3: מפעילים את Firebase באפליקציה

  1. מספריית הפרויקט של Flutter, מריצים את הפקודה הבאה כדי להתקין את האפליקציה הפלאגין העיקרי:

    flutter pub add firebase_core

  2. מספריית הפרויקט של Flutter, מריצים את הפקודה הבאה כדי לוודא שההגדרה ב-Firebase של אפליקציית Flutter עדכנית:

    flutterfire configure

  3. בקובץ lib/main.dart, מייבאים את פלאגין הליבה של Firebase ואת קובץ התצורה שיצרתם קודם:

    import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

  4. בקובץ lib/main.dart, מאתחלים את Firebase באמצעות אובייקט DefaultFirebaseOptions שיוצאו מקובץ התצורה:

    await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

  5. בונים מחדש את אפליקציית Flutter:

    flutter run

אם אתם מעדיפים להשתמש בפרויקט להדגמה, אפשר להפעיל את האמולטור של Firebase בקובץ lib/main.dart, מאתחלים את Firebase באמצעות demoProjectId (הוא צריך להתחיל ב-demo-):

  await Firebase.initializeApp(
    demoProjectId: "demo-project-id",
  );

שלב 4: הוספת יישומי פלאגין של Firebase

ניתן לגשת ל-Firebase באפליקציית Flutter דרך יישומי פלאגין ב-Firebase Flutter, אחד לכל מוצר של Firebase (לדוגמה: Cloud Firestore, Authentication, Analytics וכו').

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

כך מוסיפים פלאגין של Firebase Flutter:

  1. בתיקיית הפרויקט ב-Flutter, מריצים את הפקודה הבאה:

    flutter pub add PLUGIN_NAME

  2. מספריית הפרויקט של Flutter, מריצים את הפקודה הבאה:

    flutterfire configure

    הרצת הפקודה הזו מבטיחה שההגדרה ב-Firebase של אפליקציית Flutter שלך עדכני, בשביל Crashlytics ו-Performance Monitoring ב-Android, מוסיפה את נדרשו יישומי פלאגין של Gradle לאפליקציה.

  3. בסיום התהליך, בונים מחדש את פרויקט Flutter:

    flutter run

הכל מוכן! האפליקציות שלך ב-Flutter רשומות ומוגדרות לשימוש ב-Firebase.

יישומי פלאגין זמינים

מוצר שם הפלאגין iOS Android אינטרנט מכשיר Apple אחר
(macOS וכו')		 Windows
Analytics firebase_analytics
beta
App Check firebase_app_check
beta
Authentication firebase_auth
beta beta
Cloud Firestore cloud_firestore
beta beta
Cloud Functions cloud_functions
beta
Cloud Messaging firebase_messaging
beta
Cloud Storage firebase_storage
beta beta
Crashlytics firebase_crashlytics
beta
Dynamic Links firebase_dynamic_links
In-App Messaging firebase_in_app_messaging
Firebase התקנות firebase_app_installations
beta
כלי להורדת מודלים של למידת מכונה firebase_ml_model_downloader
beta
Performance Monitoring firebase_performance
Realtime Database firebase_database
beta
Remote Config firebase_remote_config
beta
Vertex AI in Firebase firebase_vertexai
beta

רוצה לנסות אפליקציה לדוגמה עם Analytics?

כמו כל החבילות, גם הפלאגין firebase_analytics מגיע עם תוכנית לדוגמה.

  1. פותחים אפליקציה של Flutter שכבר הגדרתם לשימוש ב-Firebase (למידע נוסף: ההוראות המפורטות בדף הזה).

  2. נכנסים לספרייה lib של האפליקציה ומוחקים את הקובץ main.dart הקיים. חדש.

  3. ממאגר התוכניות לדוגמה ב-Google Analytics, מעתיקים ומדביקים את שני הקבצים הבאים בתיקייה lib של האפליקציה:

    • main.dart
    • tabs_page.dart

  4. מפעילים את אפליקציית Flutter.

  5. נכנסים לפרויקט Firebase של האפליקציה במסוף Firebase ולוחצים על הסמל. Analytics בתפריט הניווט הימני.

    1. לוחצים על מרכז השליטה. אם הפונקציה Analytics פועלת כראוי, יופיע משתמש פעיל בלוח 'משתמשים פעילים ב-30 הדקות האחרונות' במרכז הבקרה (יכול להיות שיחלוף זמן מה עד שהלוח יאוכלס).

    2. לוחצים על DebugView. מפעילים את התכונה כדי לראות את כל האירועים שנוצרו על ידי תוכנית הדוגמה.

מידע נוסף על הגדרת Analytics זמין במדריכים למתחילים ל-iOS+‎, ל-Android ול-אינטרנט.

השלבים הבאים