التثبيت & أمبير؛ الإعداد على منصات أبل

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

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

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

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

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

  1. انتقل إلى قسم قاعدة بيانات الوقت الفعلي في وحدة تحكم 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، فإنه يعمل أيضًا على تمكين واجهة برمجة التطبيقات (API) في Cloud API Manager .

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

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

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

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

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

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

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

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

    سويفتويي

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

    سويفت

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    ج موضوعية

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

    سويفتويي

    // 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 . يجب عليك أيضًا تعطيل swizzling مندوب التطبيق. لمزيد من المعلومات، راجع تعليمات 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 هذا غير متوفر في هدف App Clip.
    var ref: DatabaseReference!

ref = Database.database().reference()

    ج موضوعية

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

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

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