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

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

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

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

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

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

  1. في وحدة تحكّم Firebase، انتقِل إلى قواعد البيانات ومساحة التخزين > قاعدة بيانات الوقت الفعلي.

  2. انقر على إنشاء قاعدة بيانات.

  3. اختَر وضعًا أوليًا لـ Firebase Security Rules:

    الوضع التجريبي

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

    لبدء استخدام حزمة تطوير البرامج (SDK) على الويب أو Apple أو Android، اختَر testmode.

    وضع القفل

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

  4. اختَر موقعًا جغرافيًا لقاعدة البيانات.

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

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

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

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

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

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

استخدِم أداة Swift Package Manager لتثبيت الملحقات المطلوبة في Firebase وإدارتها.

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

ضبط Realtime Database Security Rules

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

إعداد Firebase Realtime Database

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

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

    SwiftUI

    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:) الخاصة بمندوب تطبيقك:

    SwiftUI

    // 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.

    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 هذا على هدف "مقتطف التطبيق". 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

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

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

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