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

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

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

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

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

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

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

ضبط Realtime Database Security Rules

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

إعداد Firebase Realtime Database

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

  1. استورِد الو0/ الوحدة في101 1/، بالإضافة إلى أي101 2وحدات Firebase3/ أخرى يستخدمها مفوّض تطبيقك.FirebaseCoreUIApplicationDelegate على سبيل المثال، لاستخدام 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. اضبط مثيلاً مشتركًا في طريقة application(_:didFinishLaunchingWithOptions:) لمفوّض تطبيقك:FirebaseApp

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

ref = Database.database().reference()

    Objective-C

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

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

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