التثبيت والإعداد على أنظمة Apple الأساسية

قاعدة بيانات Firebase في الوقت الفعلي هي قاعدة بيانات مستضافة على السحابة. يتم تخزين البيانات كملف JSON ومزامنتها في الوقت الفعلي مع كل عميل متصل. عند إنشاء تطبيقات من عدّة أنظمة أساسية باستخدام حِزم تطوير البرامج (SDK) الخاصة بنظامي التشغيل Android وiOS وJavaScript، يشارك جميع عملائك مثيلاً واحدًا لقاعدة البيانات في الوقت الفعلي ويتلقّىون التحديثات تلقائيًا بأحدث البيانات.

وتتوفّر "قاعدة بيانات Firebase في الوقت الفعلي" على جميع أنظمة Apple الأساسية، بما في ذلك iOS وmacOS وmacOS Catalyst وtvOS وwatchOS. ولا تتوفّر لميزة "مقاطع التطبيقات". تشير تعليمات الإعداد في هذه الصفحة إلى نظام التشغيل iOS في أمثلة محددة، ولكنها عامة وتناسب أي نظام أساسي من Apple.

المتطلّبات الأساسية

  1. ثبِّت حزمة تطوير البرامج (SDK) لمنصّة Firebase.
  2. أضِف تطبيقك إلى مشروع Firebase في وحدة تحكُّم Firebase.

إنشاء قاعدة بيانات

  1. انتقِل إلى قسم Realtime Database ضمن وحدة تحكُّم Firebase. سيُطلب منك اختيار مشروع حالي في Firebase. اتّبِع سير عمل إنشاء قاعدة البيانات.

  2. اختَر وضع بدء لقواعد أمان Firebase:

    وضع الاختبار

    جيدة لبدء استخدام مكتبات برامج الويب والجوَّال، ولكنها تسمح لأي شخص بقراءة بياناتك واستبدالها. بعد الاختبار، احرص على مراجعة قسم فهم قواعد بيانات Firebase في الوقت الفعلي.

    لبدء استخدام الويب أو Apple أو حزمة تطوير البرامج (SDK) لنظام التشغيل Android، اختَر "وضع الاختبار".

    وضع القفل

    رفض جميع عمليات القراءة والكتابة من برامج الويب والأجهزة الجوّالة سيظل بإمكان خوادم التطبيقات التي تمت مصادقتها الوصول إلى قاعدة البيانات الخاصة بك.

  3. اختَر موقعًا لقاعدة البيانات.

    بناءً على موقع قاعدة البيانات، سيكون عنوان URL لقاعدة البيانات الجديدة بأحد الأشكال التالية:

    • DATABASE_NAME.firebaseio.com (لقواعد البيانات في us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (لقواعد البيانات في جميع المواقع الجغرافية الأخرى)

  4. انقر على تم.

عند تفعيل قاعدة البيانات في الوقت الفعلي، يتم أيضًا تفعيل واجهة برمجة التطبيقات في Cloud API Manager.

إضافة "قاعدة بيانات Firebase في الوقت الفعلي" إلى تطبيقك

يمكنك استخدام "مدير حزم Swift" لتثبيت اعتماديات Firebase وإدارتها.

  1. في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى File > Add Packages (ملف > إضافة حِزم).
  2. أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple عندما يُطلب منك ذلك:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. اختَر مكتبة قاعدة البيانات في الوقت الفعلي.
  4. أضِف العلامة -ObjC إلى القسم علامات الروابط الأخرى في إعدادات إصدار هدفك.
  5. عند الانتهاء، ستبدأ خدمة Xcode تلقائيًا في حلّ المشاكل المتعلّقة بالعناصر التي تعتمد عليها وتنزيلها في الخلفية.

إعداد قواعد أمان قاعدة البيانات في الوقت الفعلي

توفر قاعدة البيانات في الوقت الفعلي لغة قواعد تعريفية تتيح لك تحديد كيفية هيكلة البيانات وكيفية فهرستها ومتى يمكن قراءة البيانات منها وكتابتها.

إعداد قاعدة بيانات Firebase في الوقت الفعلي

يجب إعداد Firebase قبل إنشاء أو استخدام أي مرجع لتطبيق Firebase. وإذا سبق لك إجراء ذلك لميزة أخرى في Firebase، يمكنك تخطّي هذه الخطوة.

  1. يمكنك استيراد وحدة FirebaseCore في UIApplicationDelegate، بالإضافة إلى أي وحدات Firebase أخرى يستخدمها المستخدم المفوَّض في تطبيقك. على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:

    واجهة المستخدم

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. يمكنك ضبط المثيل المشترك ضمن FirebaseApp في طريقة application(_:didFinishLaunchingWithOptions:) الخاصة بمفوَّض تطبيقك:

    واجهة المستخدم

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. إذا كنت تستخدم SwiftUI، عليك إنشاء تفويض تطبيق وإرفاقه ببنية App من خلال UIApplicationDelegateAdaptor أو NSApplicationDelegateAdaptor. ويجب أيضًا إيقاف إيماءة تفويض التطبيق. لمزيد من المعلومات، راجِع تعليمات SwiftUI.

    واجهة المستخدم

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. أنشئ مرجعًا لقاعدة بياناتك وحدِّد الموقع الذي تريد الكتابة فيه.

    Swift

    ملاحظة: لا يتوفّر منتج Firebase هذا في هدف App Clip. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

    ملاحظة: لا يتوفّر منتج Firebase هذا في هدف App Clip. 
    @property (strong, nonatomic) FIRDatabaseReference *ref;

self.ref = [[FIRDatabase database] reference];

الخطوات التالية