التركيب الإعداد على أنظمة 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 في وحدة تحكّم Firebase.

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

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

2. اختَر وضعًا أوليًا لتطبيق Firebase Security Rules:

   وضع الاختبار

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

   ملاحظة: إذا أنشأت قاعدة بيانات في "الوضع التجريبي" ولم تجرِ أي تغييرات على Rules التلقائية القابلة للقراءة والكتابة من قِبل الجميع خلال فترة الإصدار التمهيدي، سيتم إعلامك عبر البريد الإلكتروني، وبعد ذلك سترفض قواعد قاعدة البيانات جميع الطلبات. سجِّل تاريخ انتهاء الصلاحية أثناء عملية إعداد Firebase console .

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

   وضع القفل

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

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

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

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

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

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

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

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

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

يمكنك الانتقال إلى دليل التثبيت للتعرّف على الطرق المختلفة التي يمكنك من خلالها إضافة حِزم تطوير البرامج (SDK) لنظام Firebase إلى مشروعك على Apple، بما في ذلك استيراد الإطارات مباشرةً واستخدام CocoaPods.

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

  https://github.com/firebase/firebase-ios-sdk.git

ملاحظة: من المفترض أن تستخدم المشاريع الجديدة أحدث إصدار من حزمة تطوير البرامج (SDK) التلقائي، ولكن يمكنك اختيار إصدار أقدم إذا لزم الأمر.
3. اختَر مكتبة Realtime Database.
4. أضِف العلامة -ObjC إلى قسم رموز ربط أخرى في إعدادات الإنشاء الخاصة بالهدف.
5. عند الانتهاء، سيبدأ Xcode تلقائيًا في حلّ ملفاتك المضمّنة وتنزيلها في الخلفية.

ضبط Realtime Database Security Rules

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

ملاحظة: يتم تلقائيًا حظر الوصول إلى قاعدة البيانات للقراءة والكتابة، ما يعني أنّه يمكن فقط للمستخدمين المعتمَدين قراءة البيانات أو كتابتها. للبدء بدون إعداد Authentication، يمكنك ضبط قواعدك للوصول العلني. ويؤدي ذلك إلى إتاحة قاعدة البيانات لأي شخص، حتى الأشخاص الذين لا يستخدمون تطبيقك، لذا احرص على تقييد قاعدة البيانات مرة أخرى عند إعداد المصادقة.

إعداد 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. أنشئ مرجعًا لقاعدة بياناتك وحدِّد الموقع الجغرافي الذي تريد الكتابة إليه.
   ملاحظة مهمة: للحصول على مرجع إلى قاعدة بيانات بخلاف قاعدة البيانات التلقائية في us-central1، عليك تمرير عنوان URL لقاعدة البيانات إلى database() (أو للسمة databaseWithURL - C). أما بالنسبة إلى قاعدة البيانات التلقائية us-central1، فيمكنك استدعاء database() (أو database) بدون وسيطات.

   يمكنك العثور على عنوان URL الخاص بـ Realtime Database في القسم Realtime Database في وحدة تحكّم Firebase. استنادًا إلى موقع قاعدة البيانات، سيكون عنوان URL لقاعدة البيانات بأحد الأشكال التالية:

   • https://DATABASE_NAME.firebaseio.com (للقواعد البيانات في us-central1)
   • https://DATABASE_NAME.REGION.firebasedatabase.app (لقواعد البيانات في جميع المواقع الجغرافية الأخرى)

   Swift

   ملاحظة: لا يتوفّر منتج Firebase هذا في استهداف "المقاطع الترويجية للتطبيقات".

   var ref: DatabaseReference!
   
   ref = Database.database().reference()

   Objective-C

   ملاحظة: لا يتوفّر منتج Firebase هذا في هدف App Clip.

   @property (strong, nonatomic) FIRDatabaseReference *ref;
   
   self.ref = [[FIRDatabase database] reference];

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

• تعرَّف على كيفية تنظيم البيانات في Realtime Database.

• توسيع نطاق بياناتك على مستوى عدّة مثيلات لقاعدة بيانات

• قراءة البيانات وكتابتها

• الاطّلاع على قاعدة البيانات في وحدة تحكّم Firebase

• تجهيز تطبيقك للإطلاق:

  • يمكنك تفعيل App Check للمساعدة في ضمان وصول تطبيقاتك فقط إلى قواعد بياناتك.

  • إعداد تنبيهات الميزانية لمشروعك في وحدة تحكّم Google Cloud

  • يمكنك مراقبة لوحة بيانات الاستخدام والفوترة في وحدة تحكّم Firebase للحصول على نظرة عامة على استخدام مشروعك على مستوى خدمات Firebase المتعددة. يمكنك أيضًا الانتقال إلى لوحة بيانات Realtime Database الاستخدام للحصول على معلومات استخدام أكثر تفصيلاً.

  • راجِع قائمة التحقّق الخاصة بإطلاق Firebase.