הוסף את Firebase לאפליקציית Flutter שלך
דרישות מוקדמות
התקן את העורך המועדף עליך או IDE .
התקן את Flutter עבור מערכת ההפעלה הספציפית שלך, כולל הפריטים הבאים:
- Flutter SDK
- ספריות תומכות
- תוכנות ו-SDK ספציפיות לפלטפורמה
היכנס ל-Firebase באמצעות חשבון Google שלך.
אם עדיין אין לך אפליקציית 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
עושה את הפעולות הבאות:
מבקש ממך לבחור את הפלטפורמות (iOS, אנדרואיד, אינטרנט) הנתמכות באפליקציית Flutter שלך. עבור כל פלטפורמה שנבחרה, FlutterFire CLI יוצר אפליקציית Firebase חדשה בפרויקט Firebase שלך.
אתה יכול לבחור להשתמש בפרויקט Firebase קיים או ליצור פרויקט Firebase חדש. אם כבר יש לך אפליקציות רשומות בפרויקט Firebase קיים, FlutterFire CLI ינסה להתאים אותם על סמך תצורת פרויקט Flutter הנוכחית שלך.
יוצר קובץ תצורה של Firebase (
firebase_options.dart
) ומוסיף אותו לספרייתlib/
שלך.(עבור Crashlytics או ניטור ביצועים באנדרואיד) מוסיף את תוספי Gradle הספציפיים למוצר הנדרשים לאפליקציית Flutter שלך.
שלב 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
המיוצא על ידי קובץ התצורה:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
בנה מחדש את אפליקציית Flutter שלך:
flutter run
שלב 4 : הוסף פלאגין של Firebase
אתה ניגש ל-Firebase באפליקציית Flutter שלך דרך התוספים השונים של Firebase Flutter , אחד עבור כל מוצר Firebase (לדוגמה: Cloud Firestore, Authentication, Analytics וכו').
מכיוון ש-Flutter היא מסגרת מרובת פלטפורמות, כל תוסף Firebase ישים עבור פלטפורמות אפל, אנדרואיד ואינטרנט. לכן, אם תוסיף פלאגין של Firebase לאפליקציית Flutter שלך, הוא ישמש את גרסאות Apple, Android והאינטרנט של האפליקציה שלך.
כך מוסיפים תוסף של Firebase Flutter:
מספריית פרויקט Flutter שלך, הפעל את הפקודה הבאה:
flutter pub add PLUGIN_NAME
מספריית פרויקט Flutter שלך, הפעל את הפקודה הבאה:
flutterfire configure
הפעלת פקודה זו מבטיחה שתצורת Firebase של אפליקציית Flutter שלך תהיה מעודכנת, ולגבי Crashlytics וניטור ביצועים באנדרואיד, מוסיפה לאפליקציה שלך את התוספים הדרושים של Gradle.
לאחר השלמת, בנה מחדש את פרויקט Flutter שלך:
flutter run
אתה מוכן! אפליקציות Flutter שלך רשומות ומוגדרות לשימוש ב-Firebase.
תוספים זמינים
מוצר | שם הפלאגין | iOS | דְמוּי אָדָם | אינטרנט | אפל אחרת (macOS וכו') | חלונות |
---|---|---|---|---|---|---|
ניתוח | firebase_analytics | בטא | ||||
בדיקת אפליקציה | firebase_app_check | בטא | ||||
אימות | firebase_auth | בטא | בטא | |||
Cloud Firestore | cloud_firestore | בטא | בטא | |||
פונקציות ענן | cloud_functions | בטא | ||||
העברת הודעות בענן | firebase_messaging | בטא | ||||
אחסון בענן | firebase_storage | בטא | בטא | |||
Crashlytics | firebase_crashlytics | בטא | ||||
קישורים דינמיים | firebase_dynamic_links | |||||
העברת הודעות בתוך האפליקציה | firebase_in_app_messaging | |||||
התקנות Firebase | firebase_app_installations | בטא | ||||
הורדת דגמי ML | firebase_ml_model_downloader | בטא | ||||
ניטור ביצועים | firebase_performance | |||||
מסד נתונים בזמן אמת | firebase_database | בטא | ||||
תצורה מרחוק | firebase_remote_config | בטא |
נסה אפליקציה לדוגמה עם Analytics
כמו כל החבילות, הפלאגין firebase_analytics
מגיע עם תוכנית לדוגמה .
פתח אפליקציית Flutter שכבר הגדרת לשימוש ב-Firebase (ראה הוראות בדף זה).
גש לספריית
lib
של האפליקציה, ואז מחק את הקובץmain.dart
הקיים.ממאגר התוכניות לדוגמה של Google Analytics , העתק והדבק את שני הקבצים הבאים בספריית
lib
של האפליקציה שלך:-
main.dart
-
tabs_page.dart
-
הפעל את אפליקציית Flutter שלך.
עבור אל פרויקט Firebase של האפליקציה שלך במסוף Firebase ולאחר מכן לחץ על Analytics בניווט השמאלי.
לחץ על לוח המחוונים . אם Analytics פועל כראוי, לוח המחוונים מציג משתמש פעיל בחלונית "משתמשים פעילים ב-30 הדקות האחרונות" (ייתכן שייקח זמן לאכלוס החלונית הזו).
לחץ על DebugView . אפשר את התכונה כדי לראות את כל האירועים שנוצרו על ידי התוכנית לדוגמה.
למידע נוסף על הגדרת Analytics, בקר במדריכי תחילת העבודה עבור iOS+ , Android ואינטרנט .
הצעדים הבאים
קבל ניסיון מעשי עם Firebase Flutter Codelab .
היכונו להפעלת האפליקציה שלכם:
- הגדר התראות תקציב עבור הפרויקט שלך במסוף Google Cloud.
- עקוב אחר לוח המחוונים של השימוש והחיובים במסוף Firebase כדי לקבל תמונה כוללת של השימוש בפרויקט שלך בשירותי Firebase מרובים.
- עיין ברשימת המשימות להפעלת Firebase .