التثبيت والإعداد على منصات Apple

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

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

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

  1. ثبّت حزمة Firebase SDK .
  2. أضف تطبيقك إلى مشروع Firebase في وحدة تحكم Firebase .

أنشئ قاعدة بيانات

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

  2. حدد وضع بدء لقواعد أمان Firebase:

    وضع الاختبار

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

    لبدء استخدام الويب أو Apple أو Android SDK ، حدد وضع الاختبار.

    وضع القفل

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

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

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

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

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

  4. انقر فوق تم .

عند تمكين Realtime Database ، فإنه يُمكِّن أيضًا واجهة برمجة التطبيقات في Cloud API Manager .

أضف Firebase Realtime Database إلى تطبيقك

استخدم Swift Package Manager لتثبيت وإدارة تبعيات Firebase.

  1. في Xcode ، مع فتح مشروع التطبيق الخاص بك ، انتقل إلى ملف> إضافة حزم .
  2. عند المطالبة ، أضف مستودع SDK لأنظمة Apple الأساسية لـ Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. اختر مكتبة قاعدة بيانات Realtime.
  4. عند الانتهاء ، سيبدأ Xcode تلقائيًا في حل وتنزيل التبعيات الخاصة بك في الخلفية.

تكوين قواعد أمان قاعدة البيانات الحقيقية

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

قم بإعداد قاعدة بيانات Firebase Realtime

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

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

    SwiftUI

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

    سويفت

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    ج موضوعية

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. قم بتهيئة مثيل FirebaseApp مشترك في application(_:didFinishLaunchingWithOptions:) :

    SwiftUI

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

    سويفت

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

    ج موضوعية

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

    SwiftUI

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

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. قم بإنشاء مرجع لقاعدة البيانات الخاصة بك وحدد الموقع الذي تريد الكتابة إليه.

    سويفت

    ملاحظة: منتج Firebase هذا غير متاح في هدف مقطع التطبيق.
    var ref: DatabaseReference!

ref = Database.database().reference()

    ج موضوعية

    ملاحظة: منتج Firebase هذا غير متاح في هدف مقطع التطبيق.
    @property (strong, nonatomic) FIRDatabaseReference *ref;

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

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