Firebase SDK لـ Swift: دليل شامل مع أمثلة

ما هو Firebase SDK لـ Swift؟

Firebase SDK (مجموعة أدوات تطوير البرمجيات) للغة Swift هو مجموعة أدوات قوية من Google، توفر لمطوري تطبيقات iOS بنية تحتية جاهزة لإنشاء الواجهة الخلفية (Backend-as-a-Service، BaaS). بدلاً من كتابة كود الخادم من الصفر، تحصل على خدمات سحابية جاهزة: قاعدة بيانات، مصادقة، تحليلات، تخزين سحابي، إشعارات دفع، وغيرها الكثير.

Firebase SDK لـ Swift يتيح لك:

\n
• تخزين البيانات في الوقت الفعلي (Firestore و Realtime Database)
\n
• مصادقة المستخدمين (البريد الإلكتروني/كلمة المرور، Google، Apple، Facebook، وغيرها)
\n
• تحميل الملفات إلى التخزين السحابي (Cloud Storage)
\n
• إرسال إشعارات الدفع (Cloud Messaging)
\n
• جمع التحليلات (Google Analytics for Firebase)
\n
• إعداد اختبار A/B (Remote Config)
\n
• تتبع الأخطاء (Crashlytics)
\n

يتم توزيع المكتبة عبر Swift Package Manager (SPM) أو CocoaPods. هذه هي مجموعة SDK الرسمية من Google، والتي يتم دعمها وتحديثها.

تثبيت Firebase SDK لـ Swift

الخيار 1: Swift Package Manager (SPM) — الطريقة الموصى بها

\n
1. افتح مشروعك في Xcode
\n
2. انتقل إلى File → Add Packages...
\n
3. أدخل رابط المستودع: https://github.com/firebase/firebase-ios-sdk.git
\n
4. اختر الإصدار المطلوب (يوصى بآخر إصدار مستقر)
\n
5. اختر الوحدات المطلوبة (مثل FirebaseFirestore، FirebaseAuth)
\n
6. اضغط على Add Package
\n

الخيار 2: CocoaPods

إذا كنت تستخدم CocoaPods، أضف إلى ملف Podfile الخاص بك:

platform :ios, '13.0'\nuse_frameworks!\n\ntarget 'YourAppName' do\n  pod 'FirebaseFirestore'\n  pod 'FirebaseAuth'\n  pod 'FirebaseStorage'\n  pod 'FirebaseAnalytics'\n  pod 'FirebaseMessaging'\nend

ثم نفذ في الطرفية:

pod install

إعداد المشروع في وحدة تحكم Firebase

\n
1. انتقل إلى console.firebase.google.com
\n
2. أنشئ مشروعًا جديدًا أو اختر مشروعًا موجودًا
\n
3. أضف تطبيق iOS
\n
4. قم بتنزيل ملف GoogleService-Info.plist
\n
5. اسحبه وأفلته في جذر مشروع Xcode الخاص بك
\n

بداية سريعة مع مثال كود

بعد التثبيت والإعداد، قم بتهيئة Firebase في AppDelegate.swift:

import UIKit\nimport FirebaseCore\n\n@main\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n    func application(_ application: UIApplication,\n                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {\n        FirebaseApp.configure()\n        return true\n    }\n}

الآن يمكنك استخدام Firebase. مثال بسيط لكتابة وقراءة البيانات من Firestore:

import FirebaseFirestore\n\nclass ViewController: UIViewController {\n    let db = Firestore.firestore()\n\n    override func viewDidLoad() {\n        super.viewDidLoad()\n        addUser()\n        readUsers()\n    }\n\n    func addUser() {\n        db.collection("users").addDocument(data: [\n            "name": "إيفان بيتروف",\n            "age": 25,\n            "email": "ivan@example.com"\n        ]) { error in\n            if let error = error {\n                print("خطأ في الإضافة: \\(error.localizedDescription)")\n            } else {\n                print("تمت إضافة المستخدم بنجاح!")\n            }\n        }\n    }\n\n    func readUsers() {\n        db.