‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

Apple

מגדירים מכשיר פיזי של אפל או משתמשים בסימולטור כדי להריץ את האפליקציה.
חשוב לוודא שהאפליקציה שנוצרה ב-Flutter מיועדת לגרסאות הפלטפורמה הבאות או לגרסאות מתקדמות יותר:
- ‫iOS 15
- ‫macOS 11

רוצה להשתמש ב-Cloud Messaging?

אלה הדרישות המוקדמות לשימוש ב-Cloud Messaging בפלטפורמות של Apple:

הגדרת מכשיר פיזי של Apple.

משיגים מפתח אימות של שירות ההתראות של אפל (APNs) לחשבון הפיתוח של אפל.

מפעילים התראות ב-Xcode בקטע App > Capabilities (אפליקציה > יכולות).

Android

מגדירים מכשיר או אמולטור להרצת האפליקציה. אמולטורים צריכים להשתמש בתמונת אמולטור עם Google Play.
צריך לוודא שהאפליקציה עומדת בדרישות הבאות:
- מטרגט לרמת ה-API המיועדת 24 (Nougat) ומעלה
- מכשיר עם Android מגרסה 7.0 ואילך

אינטרנט

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

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

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

אם עדיין לא עשיתם זאת, מתקינים את Firebase CLI.
כדי להיכנס ל-Firebase באמצעות חשבון Google, מריצים את הפקודה הבאה:
```
firebase login
```
מריצים את הפקודה הבאה מכל ספרייה כדי להתקין את FlutterFire CLI:
```
dart pub global activate flutterfire_cli
```

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

משתמשים ב-FlutterFire CLI כדי להגדיר את אפליקציות Flutter להתחבר ל-Firebase.

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

flutterfire configure

מה תהליך העבודה הזה של flutterfire configure עושה?

תהליך העבודה של flutterfire configure מבצע את הפעולות הבאות:

תתבקשו לבחור את הפלטפורמות (iOS, ‏ Android, אינטרנט) שנתמכות באפליקציית Flutter. לכל פלטפורמה שתבחרו, ה-CLI של FlutterFire ייצור אפליקציית Firebase חדשה בפרויקט Firebase.

אתם יכולים לבחור אם להשתמש בפרויקט קיים ב-Firebase או ליצור פרויקט חדש. אם כבר יש לכם אפליקציות שרשומות בפרויקט קיים ב-Firebase, ה-CLI של FlutterFire ינסה להתאים אותן על סמך ההגדרות הנוכחיות של הפרויקט ב-Flutter.

הערה: ריכזנו כאן כמה טיפים להגדרה ולניהול של פרויקט ב-Firebase:

בשיטות המומלצות שלנו מוסבר איך להוסיף אפליקציות לפרויקט Firebase, כולל איך לטפל בכמה וריאציות.

מפעילים את Google Analytics בפרויקט, כדי ליהנות מחוויית שימוש אופטימלית במוצרים רבים של Firebase, כמו Crashlytics ו-Remote Config.

יוצר קובץ הגדרות של Firebase ‏ (firebase_options.dart) ומוסיף אותו לתיקייה lib/.

הערה: קובץ ההגדרות הזה של Firebase מכיל מזהים ייחודיים, אבל לא סודיים, לכל פלטפורמה שבחרתם.
מידע נוסף על קובץ התצורה הזה זמין במאמר הסבר על פרויקטים ב-Firebase.

(לגרסה Crashlytics או Performance Monitoring ב-Android) מוסיף לאפליקציית Flutter את הפלאגינים הספציפיים למוצר של Gradle שנדרשים.

הערה: כדי שממשק FlutterFire CLI יוסיף את התוסף המתאים של Gradle, צריך לייבא את תוסף Flutter של המוצר לאפליקציית Flutter.

אחרי ההרצה הראשונית של flutterfire configure, צריך להריץ מחדש את הפקודה בכל פעם ש:

התחלת תמיכה בפלטפורמה חדשה באפליקציית Flutter.
מתחילים להשתמש בשירות או במוצר חדש של Firebase באפליקציית Flutter, במיוחד אם מתחילים להשתמש בכניסה באמצעות חשבון Google, ב-Crashlytics, ב-Performance Monitoring או ב-Realtime Database.

הפעלת הפקודה מחדש מבטיחה שההגדרות של Firebase באפליקציית Flutter יהיו עדכניות, ומוסיפה באופן אוטומטי (ב-Android) את כל הפלאגינים הנדרשים של Gradle לאפליקציה.

שלב 3: הפעלת Firebase באפליקציה

בספריית הפרויקט של Flutter, מריצים את הפקודה הבאה כדי להתקין את הפלאגין הראשי:
```
flutter pub add firebase_core
```
בתיקיית הפרויקט ב-Flutter, מריצים את הפקודה הבאה כדי לוודא שהגדרות Firebase של האפליקציה ב-Flutter מעודכנות:
```
flutterfire configure
```
בקובץ lib/main.dart, מייבאים את הפלאגין הראשי של Firebase ואת קובץ התצורה שיצרתם קודם:
```
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
```

גם בקובץ lib/main.dart, מאתחלים את Firebase באמצעות האובייקט DefaultFirebaseOptions שיוצא על ידי קובץ התצורה:

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

בונים מחדש את אפליקציית 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:

בספריית הפרויקט ב-Flutter, מריצים את הפקודה הבאה:
```
flutter pub add PLUGIN_NAME
```
בספריית הפרויקט ב-Flutter, מריצים את הפקודה הבאה:
```
flutterfire configure
```
הפעלת הפקודה הזו מוודאת שההגדרה של Firebase באפליקציית Flutter מעודכנת, ובגרסאות Crashlytics ו-Performance Monitoring ב-Android, מוסיפה לאפליקציה את הפלאגינים הנדרשים של Gradle.
בסיום, בונים מחדש את פרויקט Flutter:
```
flutter run
```

סיימת! אפליקציות Flutter רשומות ומוגדרות לשימוש ב-Firebase.

שיקולים מיוחדים לפיתוח אפליקציות אינטרנט

כדאי לעיין באפשרויות ההגדרה הבאות כשמטרגטים את פלטפורמת האינטרנט.

תמיכה ב-Trusted Types

ערכת ה-SDK של Firebase ל-Flutter תומכת בשימוש ב-Trusted Types כדי למנוע התקפות XSS מבוססות-DOM (בצד הלקוח). כשמפעילים את האכיפה של סוגים מהימנים באפליקציה, Firebase SDK מוסיף את הסקריפטים שלו ל-DOM באמצעות מדיניות מותאמת אישית של סוגים מהימנים, שנקראת flutterfire-firebase_core,‏ flutterfire-firebase_auth וכו'.

השבתת ההזרקה האוטומטית של Firebase JavaScript SDK

כברירת מחדל, Firebase Flutter SDK מזריק אוטומטית את Firebase JavaScript SDK כשמבצעים בנייה לאינטרנט. אם אתם לא רוצים ש-Firebase JavaScript SDK יוטמע אוטומטית, אתם יכולים לעשות את הפעולות הבאות:

כדי להתעלם מהסקריפט של ההזרקה האוטומטית, מוסיפים את המאפיין הבא לתג <script> בקובץ web/index.html בפרויקט Flutter:

<!-- Add this property inside a <script> tag within your "web/index.html" file in your Flutter project -->
<!-- Put in the names of all the plugins you wish to ignore: -->
window.flutterfire_ignore_scripts = ['analytics', 'firestore'];

טוענים את הסקריפט באופן ידני באמצעות אחת מהאפשרויות הבאות:

אפשרות 1: מוסיפים את ה-SDK באופן מפורש לקובץ web/index.html, בתוך פונקציית ה-callback‏ window.addEventListener:

  window.addEventListener('load', async function (ev) {
    window.firebase_firestore = await import("https://www.gstatic.com/firebasejs/13.0.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/13.0.0/firebase-analytics.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

אפשרות 2: מורידים את קוד Firebase JavaScript SDK של הפלאגין מהדומיין gstatic ושומרים אותו בקובץ JavaScript שיישמר בפרויקט וייטען באופן ידני:

  // "web/my-analytics.js" & "web/my-firestore.js" file loaded as a script into your "web/index.html" file:
  window.addEventListener('load', async function (ev) {
    window.firebase_analytics = await import("./my-analytics.js");
    window.firebase_firestore = await import("./my-firestore.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

פלאגינים זמינים

מוצר	שם הפלאגין	מכשירים אחרים של אפל (macOS וכו')	Windows
Firebase AI Logic ¹	`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 ²	`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".}

השלבים הבאים

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