دليلك الشامل لربط تطبيق فلاتر بفايربيز (Firebase Integration with Flutter)
أهلاً بك يا صديقي المبرمج. أكيد جالك وقت وأنت بتبني تطبيق بـ فلاتر (Flutter) وفكرت: هو أنا هعمل "باك إند" (Backend) إزاي؟ هتعلم نود جي إس (Node.js) ولا أروح لـ بايثون (Python)؟ وهجيب سيرفر منين؟ وهدفع كام في الاستضافة؟ هنا بقى بيجي دور البطل الخارق في عالم التطوير: فايربيز (Firebase).
فايربيز (Firebase) مش مجرد قاعدة بيانات، ده "باك إند" كامل جاهز، بيقدم لك كل اللي تحتاجه عشان تطبيقك يشتغل ويسمع مع المستخدمين من غير ما تشغل بالك بتعقيدات السيرفرات. في المقال ده، هناخدك في رحلة عملية عشان تربط تطبيقك بـ فايربيز وتستفيد من أقوى خدماته زي الـ Auth والـ Firestore.
Table of contents [Show]
الخطوة الأولى: تهيئة المشروع على منصة فايربيز (Console Setup)
قبل ما نلمس الكود، لازم نعرف فايربيز إحنا مين. ادخل على موقع Firebase Console واعمل مشروع جديد. بعد ما المشروع يتكريت، هتلاقي أيقونات لأنظمة التشغيل (أندرويد، آي أو إس، ويب). اختار اللي يهمك، ومهم جداً يكون معاك الـ Package Name الخاص بتطبيقك (هتلاقيه في ملف android/app/build.gradle).
بعد ما تحمل ملف الـ google-services.json للأندرويد أو GoogleService-Info.plist للآيفون، حطهم في المسارات الصحيحة داخل ملفات مشروعك. الخطوة دي هي حجر الأساس، ومن غيرها التطبيق مش هيقدر يكلم خدمات جوجل.
الخطوة الثانية: إعداد فلاتر (Flutter Configuration)
عشان نربط الـ SDK في مشروعنا، لازم نستخدم إضافة flutterfire_cli. دي أداة بتسهل عليك كل حاجة بدل ما تقعد تعدل في ملفات Gradle يدوياً. افتح الـ Terminal في مسار مشروعك واكتب:
dart pub global activate flutterfire_cli
flutterfire configure
الأداة دي هتعمل "ماجيك" وهتخليك تختار المشروع اللي كريته على الويب، وهتنشئ ملف اسمه firebase_options.dart. الملف ده هو اللي فيه كل "المفاتيح" اللي تطبيقك محتاجها عشان يفتح قفل خدمات فايربيز.
الخطوة الثالثة: تفعيل خدمات الـ Auth و الـ Firestore
أشهر حاجتين بنحتاجهم هما: Firebase Authentication لتسجيل دخول المستخدمين، و Cloud Firestore لتخزين البيانات. ادخل على صفحة الخدمات في لوحة تحكم فايربيز، واضغط على "Enable" أو "تفعيل".
في الكود بتاعك، لازم تعمل "Initialization" لفايربيز في دالة الـ main:
void main() async {
WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
runApp(MyApp());
}
الخطوة الرابعة: التعامل مع البيانات (Firebase Firestore)
عشان تضيف بيانات لقاعدة البيانات، الموضوع بسيط جداً. فايربيز بيتعامل بنظام "الكوليكشنز" (Collections) والـ "ديكيومنتس" (Documents). مثال بسيط لإضافة بيانات:
FirebaseFirestore.instance.collection('users').add({
'full_name': 'Ahmed Mohamed',
'age': 25,
});
وكده البيانات سمعت فوراً في السيرفر! ميزة فايربيز الحقيقية هي الـ Real-time Database، يعني لو عدلت حاجة في السيرفر، هتسمع في تطبيق المستخدم فوراً من غير ما يعمل "ريفريش".
نصيحة من أخ لمبرمج
بص يا بطل، فايربيز سهل جداً، بس الفخ اللي بيقع فيه المبتدئين هو "الأمن" (Security Rules). دايماً ادخل على تبويب Rules في Firestore واضبط الصلاحيات بحيث مفيش حد يقدر يقرأ أو يكتب إلا المستخدم المسجل (Authenticated User). اتعلم الـ Rules كويس لأنها بتحمي بيانات مستخدمينك من أي تلاعب.
ابدأ بمشروع صغير، جرب تسجيل الدخول، وبعدها اتنقل لـ Firestore، ومع الوقت هتكتشف أدوات تانية زي Firebase Functions و Firebase Storage اللي هتخلي تطبيقك "حوت" في السوق.
بالتوفيق في رحلتك مع فلاتر وفايربيز، ولو وقفت قدامك حاجة، افتكر إن الـ Documentation هو صديقك الصدوق!
