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

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

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

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

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

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

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

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

    وضع الاختبار

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

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

    وضع القفل

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

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

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

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

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

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

عند تمكين قاعدة البيانات في الوقت الفعلي، فإنها تؤدي أيضًا إلى تمكين واجهة برمجة التطبيقات في مدير Cloud API

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

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

  1. في Xcode، انتقِل إلى File (ملف) > بعد فتح مشروع التطبيق الخاص بك. إضافة حِزم
  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];

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