التركيب الإعداد على أنظمة 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. انتقِل إلى القسم Realtime Database في Firebase وحدة التحكّم. سيُطلب منك اختيار مشروع حالي على Firebase. اتّبِع سير عمل إنشاء قاعدة البيانات.

2. اختَر وضعًا لبدء Firebase Security Rules:

   وضع الاختبار

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

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

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

   وضع القفل

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

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 وإدارتها.

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

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

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

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

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

• كيفية تنظيم البيانات من أجل Realtime Database

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

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

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

• استعِدّ لإطلاق تطبيقك باتّباع الخطوات التالية:

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

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

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

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