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

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

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

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

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

Apple

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

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

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

מגדירים מכשיר פיזי של אפל.

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

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

Android

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

אינטרנט

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

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

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

אם עדיין לא עשיתם את זה, התקינו את ה-CLI של Firebase.
מריצים את הפקודה הבאה כדי להתחבר ל-Firebase באמצעות חשבון Google:
```
firebase login
```
מתקינים את ה-CLI של FlutterFire על ידי הפעלת הפקודה הבאה מכל ספרייה:
```
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 מעודכנת, ומוסיפה לאפליקציה את הפלאגינים הנדרשים של Gradle ל-Crashlytics ול-Performance Monitoring ב-Android.
בסיום, בונים מחדש את פרויקט 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.1.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/13.1.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".}

השלבים הבאים

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