هناك أكثر من طريقة لإضافة Firebase الى تطبيقات Flutter، ولكن افضل طريقه سريعة وأكثر بساطة بدون الكثير من الخطوات هو بإستخدام Firebase CLI. سنتعرف هنا على طريقة اضافة Firebase وهذا الدرس سيكون مرجع لبقية الدروس التي استخدام فيها Firebae.
ماهو Firebase CLI ؟
أداة “Command Line Interface” تسمح لك بانشاء وإدارة خدمات Firebase من موجه الآوامر مباشرة.
- نشر الاكواد الى Firebase.
- استخدام Local host لمواقع الويب المنشورة على Firebase.
- التعامل مع البيانات في قواعد بيانات Firebase.
- اضافة وحذف المستخدمين من Firebase Auth.
التثبيت:
– التثبيت عن طريق npm
يمكن تثبيت Firebase CLI بإستخدام Node Packages Manager، تحتاج اولا تحميل npm في جهازك اذ لم يكن موجود.
npm install -g firebase-tools
هذا الأمر يسمح لك بإستخدام firebase في جميع انحاء الجهاز Globaly.
– تثبيت نسخة مستقلة
الأمر التالي يسمح لك بتثبيت firebase بدون الحاجة الى اي متطلبات مثل الأمر السابق الذي يتطلب npm.
curl -sL firebase.tools | bash
أهم الأوامر
لمعرفة الأوامر الموجودة وطريقة استخدامها فيمكن القيام بهذا الأمر firebase --help
، اما اذا اردت ان تعرف معلومات عن أمر محدد يمكنك استخدام هذه التعليمة firebase <command> --help
بحيث يشير command
الى الأمر الذي تريد معرفة معلومات عنه.
جدول الأوامر:
في الاسفل يوجد جدول الأوامر، يحتوي على بعض الأوامر المهمة الذي تحتاج للتعامل معها باستمرار.
Command | Description |
---|---|
login | تسجيل الدخول، ويحتاج الى فتح المتصفح لتأكيد التسجيل. |
logout | تسجيل الخروج من Firebase CLI |
login:ci | انشاء مستخدم في بيئة غير متفاعلة |
login:add | السماح بـمستخدم جديد |
login:list | قائمة بالمستخدمين المصرحين |
login:use | وضع مستخدم افتراضي لهذا المشروع |
use | تحديد مشروع Firebase |
open | فتح المتصفح لصفحة المشروع التالي |
init | انشاء وتهيئة مشروع جديد، سيقوم بانشاء ملف firebase.json |
help | مساعدة لمعرفة الأوامر وشرح مبسط عنها. |
اضافة flutterfire :
١. تثبيت flutterfire
سنقوم الآن بتثبيت CLI الخاص بإاضافة مشروع Firebase الى Flutter. لكن بداية نحتاج الى تسجيل الدخول باستخدام هذا الأمر.
firebase login
الآن باستخدام dart سنقوم بتثبيت flutterfire باستخدام هذا الأمر.
dart pub global activate flutterfire_cli
٢. تجهيز مشروعك لإستخام Firebase.
ادخل الى مشروعك او مسار مشروعك، ثم اكتب الأمر التالي. بعد ذلك سيقوم flutterfire بعرض قائمة بالماريع الموجودة مسبقًا بالإضافة الى السماح لك بإنشاء مشروع جديد.
flutterfire configure
عند إضافة اي خدمة من Firebase تحتاج الي تشغيل هذا الأمر مرة أُخرى.
٣. تهيئة مشروعك وإضافة Firebase.
- افتح موجه الاوامر على مسار مشروعك وقم بإضافة حُزمة
firevase_core
.
flutter pub add firebase_core
- كما ذكرنا سابقًا، كل مرة تضاف خدمة يجب تشغيل الأمر التالي للتأكد ان مشروعك مُحدث بجميع المتطلبات.
flutterfire configure
- الآن في مشروعك وبالتحديد في
main.dart
قم بإضافة Firebase Core و الملف الذي تم انشاءه من قبل الأمر السابق.
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
- في نفس الملف وداخل
main function
قم باضافة السطرين التالية والتي هي export من الملف السابق.
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
- شغل المشروع.
flutter run
الآن اصبحت Firebase مجهزة في تطبيق بأقل الخطوات الممكنه. يمكنك استخدام الامر السابق لاضافة اي حُزمة خاصة بـFirebase مع التأكيد ان بعد كل اضافة لخدمة Firebase تحتاج لتشغيل الأمر التالي.
flutterfire configure
الخاتمة.
تتيح لك Firebase العديد من الخدمات، ليست فقط لرنشاد قواعد البيانات فهناك التحليلات وتعلم الآلة واختبار تطبيقك وايضًا التنبيهات والخ.
Pingback: التنبيهات بإستخدام FCM في تطبيقات Flutter في Foreground. – احمد الجعيد