دليل Firebase Android SDK مع Kotlin: أمثلة وتثبيت

1. ما هو Firebase Android SDK ولماذا تحتاجه

Firebase Android SDK هو مجموعة أدوات قوية من Google توفر للمطورين بنية تحتية خلفية جاهزة للتطبيقات المحمولة. بدلاً من إنشاء وصيانة خادم خلفي خاص بك، يمكنك استخدام Firebase لمصادقة المستخدمين، وتخزين البيانات في الوقت الفعلي، وإرسال الإشعارات الفورية، والتحليلات، وغير ذلك الكثير. تتكامل المكتبة بالكامل مع نظام Android البيئي وهي مكتوبة بلغة Kotlin مع مراعاة جميع ممارسات التطوير الحديثة.

الهدف الرئيسي لـ Firebase هو تسريع تطوير التطبيقات من خلال إعفاء الفرق من الحاجة إلى كتابة كود خادم معقد. تحصل على واجهات برمجة تطبيقات جاهزة للعمل مع قواعد البيانات (Cloud Firestore و Realtime Database)، والتخزين السحابي (Cloud Storage)، والمصادقة (Firebase Auth)، والتحليلات (Google Analytics for Firebase)، وحتى التعلم الآلي (ML Kit). جميع الخدمات قابلة للتوسع بسهولة ولا تتطلب إدارة الخوادم.

لمطوري Kotlin، يقدم Firebase واجهات برمجة تطبيقات مطبعة بالكامل مع دعم coroutines و Flow وغيرها من الميزات الحديثة للغة. وهذا يجعل الكود أكثر أمانًا وقابلية للقراءة وأداءً. تُستخدم المكتبة في ملايين التطبيقات حول العالم، بما في ذلك عمالقة مثل The New York Times و Duolingo و Shazam.

2. التثبيت

يتم تثبيت Firebase Android SDK من خلال نظام إدارة التبعيات Gradle. على عكس pip أو npm، لا توجد أمر واحد هنا - بل تحتاج إلى إضافة عدة أسطر إلى ملفات المشروع.

الخطوة 1: إضافة إضافة Google Services

في ملف build.gradle.kts الجذر (مستوى المشروع)، أضف:

plugins {
    id("com.google.gms.google-services") version "4.4.2" apply false
}

الخطوة 2: ربط Firebase BoM والتبعيات

في ملف build.gradle.kts لوحدة التطبيق (app)، أضف:

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.gms.google-services")
}

dependencies {
    // Firebase Bill of Materials - يدير الإصدارات
    implementation(platform("com.google.firebase:firebase-bom:33.1.0"))
    
    // الوحدات الأساسية لـ Firebase
    implementation("com.google.firebase:firebase-analytics")
    implementation("com.google.firebase:firebase-auth")
    implementation("com.google.firebase:firebase-firestore")
    implementation("com.google.firebase:firebase-storage")
    implementation("com.google.firebase:firebase-messaging")
    implementation("com.google.firebase:firebase-config")
}

الخطوة 3: ملف google-services.json

قم بتنزيل ملف google-services.json من وحدة تحكم Firebase وضعه في مجلد app/ الخاص بمشروعك. يحتوي هذا الملف على جميع المفاتيح والمعرفات اللازمة للاتصال بمشروع Firebase الخاص بك.

3. بداية سريعة - مثال عملي بسيط

لنقم بإنشاء تطبيق بسيط يسجل حدث فتح الشاشة في Firebase Analytics.

// MainActivity.kt
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import com.google.firebase.analytics.FirebaseAnalytics
import com.google.firebase.analytics.ktx.analytics
import com.google.firebase.ktx.Firebase

class MainActivity : AppCompatActivity() {
    
    private lateinit var firebaseAnalytics: FirebaseAnalytics

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        
        // تهيئة Firebase Analytics
        firebaseAnalytics = Firebase.analytics
        
        // تسجيل حدث فتح الشاشة
        val bundle = Bundle().apply {
            putString(FirebaseAnalytics.Param.SCREEN_NAME, "MainScreen")
            putString(FirebaseAnalytics.Param.SCREEN_CLA