הוספת 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 שיוצאו מקובץ התצורה:

    WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());

  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 היא מסגרת מרובת פלטפורמות, ולכן כל פלאגין של 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
Data Connect firebase_data_connect
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 ואינטרנט.

השלבים הבאים