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


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

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

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

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

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

    firebase login

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

    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 מתאים לפלטפורמות של 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
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
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

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

התנסות באפליקציה לדוגמה באמצעות 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 ואינטרנט.

השלבים הבאים