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


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

  • מתקינים את העורך או סביבת הפיתוח המשולבת (IDE) המועדפים עליכם.

  • מגדירים מכשיר פיזי של Apple או משתמשים בסימולטור כדי להריץ את האפליקציה.

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

    • iOS 13
    • macOS 10.15

  • מתקינים את Flutter למערכת ההפעלה הספציפית שלכם, כולל:

    • Flutter SDK
    • ספריות תמיכה
    • תוכנות וערכות SDK ספציפיות לפלטפורמה

  • נכנסים ל-Firebase באמצעות חשבון Google.

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

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

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

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

    firebase login

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

    dart pub global activate flutterfire_cli

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

שימוש ב-CLI של FlutterFire כדי להגדיר את אפליקציות 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
ML Model Downloader 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 ואינטרנט.

השלבים הבאים