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

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

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

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

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

Apple

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

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

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

מגדירים מכשיר Apple פיזי.

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

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

Android

מגדירים מכשיר או אמולטור להרצת האפליקציה. אמולטורים צריכים להשתמש בתמונת אמולטור עם Google Play.
חשוב לוודא שהאפליקציה עומדת בדרישות הבאות:
- מטרגט לרמת API‏ 23 (Marshmallow) ומעלה
- מערכת ההפעלה היא Android מגרסה 6.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, ‏ Web) שנתמכות באפליקציית Flutter. לכל פלטפורמה שתבחרו, FlutterFire CLI ייצור אפליקציית Firebase חדשה בפרויקט 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 מתאים לפלטפורמות של Apple,‏ 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.

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

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

תמיכה בסוגים מהימנים

‫Firebase SDK for 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, בתוך הקריאה החוזרת window.addEventListener:

  window.addEventListener('load', async function (ev) {
    window.firebase_firestore = await import("https://www.gstatic.com/firebasejs/12.19.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/12.19.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`
ML Model Downloader	`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.