תחילת העבודה עם Firebase בפרויקט Flutter

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

דרישות מוקדמות ספציפיות לפלטפורמה:

Apple

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

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

    • iOS 15
    • macOS 11

Android

  • מגדירים מכשיר או אמולטור להרצת האפליקציה. באמולטורים צריך להשתמש בתמונת אמולטור עם Google Play.

  • צריך לוודא שהאפליקציה עומדת בדרישות הבאות:

    • מטרגטת את רמת ה-API‏ 24 (Nougat) ומעלה
    • מכשיר עם Android מגרסה 7.0 ואילך

אינטרנט

אין דרישות מוקדמות ספציפיות לפלטפורמה

אם עדיין אין לכם אפליקציית 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 Emulator ובקובץ 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 מתאים לפלטפורמות של אפל, של 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 אינטרנט מכשירים אחרים של אפל
(macOS וכו')
Windows
Firebase AI Logic 1 firebase_ai
beta
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
In-App Messaging firebase_in_app_messaging
Firebase התקנות firebase_app_installations
beta
Performance Monitoring firebase_performance
Realtime Database firebase_database
beta
Remote Config firebase_remote_config
beta
SQL Connect 2 firebase_data_connect
ספריות שהוצאו משימוש או שלא נתמכות
Dynamic Links firebase_dynamic_links
הורדת מודלים של למידת מכונה firebase_ml_model_downloader
beta

1 Firebase AI Logic נקרא בעבר "Vertex AI in Firebase" עם הפלאגין firebase_vertexai.

‫ ‫2 בעבר, Firebase SQL Connect נקרא "Firebase Data Connect".



השלבים הבאים