Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

Apple

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

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

Cloud Messaging כדי להשתמש ב-Apple Platforms, צריך לעמוד בדרישות הבאות:

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

מקבלים מפתח אימות של Apple Push Notification עבור חשבון הפיתוח של Apple.

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

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

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

‫Firebase SDK ל-Flutter תומך בשימוש ב-Trusted Types כדי לעזור למנוע מתקפות XSS מבוססות-DOM (בצד הלקוח). כשמפעילים את האכיפה של Trusted Type באפליקציה, Firebase SDK מחדיר את הסקריפטים שלו ל-DOM באמצעות מדיניות מותאמת אישית של Trusted Type, שנקראת 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.13.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/12.13.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

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

מוצר	שם הפלאגין	מכשירי Apple אחרים (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
SQL 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.}

^{2 Firebase SQL Connect נקרא בעבר
'Firebase Data Connect'.}

השלבים הבאים

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