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

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

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

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

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

  • מטרגטת לרמת API ‏23 (Marshmallow) ומעלה
  • מכשיר Android מגרסה 6.0 ואילך

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

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

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

אם עדיין אין לכם אפליקציית 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 Core ואת קובץ ההגדרות שיצרתם קודם:

   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.

תוספים זמינים

^{‫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 ול-web.

השלבים הבאים

• כדאי להתנסות בסדנת הקוד Firebase Flutter.

• הכנות להשקת האפליקציה:

  • מגדירים התראות על תקציב לפרויקט במסוף Google Cloud.
  • כדי לקבל תמונה כוללת של השימוש בפרויקט בשירותי Firebase שונים, אפשר לעקוב אחרי לוח הבקרה 'שימוש וחיוב' במסוף Firebase.
  • עיון ברשימת המשימות להשקה של Firebase.