إضافة Firebase إلى مشروع Apple

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

• ثبِّت ما يلي:

  • الإصدار 26.2 من Xcode أو إصدار أحدث

• تأكَّد من أنّ مشروعك يستوفي المتطلبات التالية:

  • يجب أن يستهدف مشروعك إصدارات الأنظمة الأساسية التالية أو الإصدارات الأحدث:
    • iOS 15
    • الإصدار 11 من نظام التشغيل macOS
    • tvOS 15
    • watchOS 8

• اضبط جهاز Apple فعليًا أو استخدِم محاكيًا لتشغيل تطبيقك.

  هل تريد استخدام Cloud Messaging؟

  في ما يلي المتطلبات الأساسية لاستخدام "Cloud Messaging" على منصات Apple:

  • إعداد جهاز Apple
  • احصل على مفتاح مصادقة الإشعارات الفورية من Apple لحساب المطوّر على Apple.
  • فعِّل الإشعارات الفورية في Xcode ضمن التطبيق > الإمكانات.

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

الخطوة 1: إنشاء مشروع Firebase

قبل إضافة Firebase إلى تطبيق Apple، عليك إنشاء مشروع على Firebase لربطه بتطبيقك. يمكنك الانتقال إلى مقالة فهم مشاريع Firebase لمعرفة المزيد عن مشاريع Firebase.

الاطّلاع على تعليمات إنشاء مشروع على Firebase

مستخدم جديد في Firebase أو Cloud

اتّبِع الخطوات التالية إذا كنت مستخدمًا جديدًا لمنصّة Firebase أو Google Cloud.
يمكنك أيضًا اتّباع هذه الخطوات إذا أردت إنشاء مشروع جديد كليًا على Firebase (ومشروع Google Cloud الأساسي).

1. سجِّل الدخول إلى وحدة تحكّم Firebase.
2. انقر على الزر لإنشاء مشروع Firebase جديد.

3. في حقل النص، أدخِل اسم المشروع.

   إذا كنت جزءًا من مؤسسة "Google Cloud"، يمكنك اختياريًا تحديد المجلد الذي تريد إنشاء مشروعك فيه.

4. راجِع بنود Firebase واقبلها إذا طُلب منك ذلك، ثم انقر على متابعة.
5. (اختياري) يمكنك تفعيل المساعدة المستندة إلى الذكاء الاصطناعي في وحدة تحكّم Firebase (المعروفة باسم "Gemini في Firebase")، والتي يمكن أن تساعدك في البدء وتبسيط عملية التطوير.

6. (اختياري) يمكنك إعداد Google Analytics لمشروعك، ما يتيح لك الاستفادة من تجربة مثالية باستخدام منتجات Firebase التالية: Firebase A/B Testing وCloud Messaging وCrashlytics وIn-App Messaging وRemote Config (بما في ذلك التخصيص).

   اختَر حسابًا حاليًا على Google Analytics أو أنشِئ حسابًا جديدًا. إذا أنشأت حسابًا جديدًا، اختَر موقع إعداد تقارير Analytics، ثم وافِق على إعدادات مشاركة البيانات وبنود Google Analytics لمشروعك.

7. انقر على إنشاء مشروع.

ينشئ Firebase مشروعك، ويوفّر بعض الموارد الأولية، ويفعّل واجهات برمجة التطبيقات المهمة. عند اكتمال العملية، سيتم نقلك إلى صفحة النظرة العامة لمشروع Firebase في وحدة تحكّم Firebase.

مشروع حالي على السحابة الإلكترونية

اتّبِع هذه الخطوات إذا أردت بدء استخدام Firebase مع مشروع حالي على Google Cloud. يمكنك الاطّلاع على مزيد من المعلومات عن "إضافة Firebase" إلى مشروع Google Cloud حالي وتحديد المشاكل وحلّها.

1. سجِّل الدخول إلى وحدة تحكّم Firebase باستخدام الحساب الذي يمنحك إمكانية الوصول إلى مشروع Google Cloud الحالي.
2. انقر على الزر لإنشاء مشروع Firebase جديد.
3. في أسفل الصفحة، انقر على إضافة Firebase إلى مشروع Google Cloud.
4. في حقل النص، ابدأ بإدخال اسم المشروع الحالي، ثم اختَر المشروع من القائمة المعروضة.
5. انقر على فتح المشروع.
6. راجِع بنود Firebase واقبلها إذا طُلب منك ذلك، ثم انقر على متابعة.
7. (اختياري) يمكنك تفعيل المساعدة المستندة إلى الذكاء الاصطناعي في وحدة تحكّم Firebase (المعروفة باسم "Gemini في Firebase")، والتي يمكن أن تساعدك في البدء وتبسيط عملية التطوير.

8. (اختياري) يمكنك إعداد Google Analytics لمشروعك، ما يتيح لك الاستفادة من تجربة مثالية باستخدام منتجات Firebase التالية: Firebase A/B Testing وCloud Messaging وCrashlytics وIn-App Messaging وRemote Config (بما في ذلك التخصيص).

   اختَر حسابًا حاليًا على Google Analytics أو أنشِئ حسابًا جديدًا. إذا أنشأت حسابًا جديدًا، اختَر موقع إعداد تقارير Analytics، ثم وافِق على إعدادات مشاركة البيانات وبنود Google Analytics لمشروعك.

9. انقر على إضافة Firebase.

تضيف منصة Firebase Firebase إلى مشروعك الحالي. عند اكتمال العملية، سيتم نقلك إلى صفحة النظرة العامة لمشروع Firebase في وحدة تحكّم Firebase.

الخطوة 2: تسجيل تطبيقك في Firebase

لاستخدام Firebase في تطبيق Apple، عليك تسجيل تطبيقك في مشروع Firebase. غالبًا ما يُطلق على تسجيل تطبيقك اسم "إضافة" تطبيقك إلى مشروعك.

1. انتقِل إلى وحدة تحكّم Firebase.

2. في منتصف صفحة "نظرة عامة على المشروع"، انقر على رمز iOS+‎ لبدء عملية الإعداد.

   إذا سبق لك إضافة تطبيق إلى مشروع Firebase، انقر على إضافة تطبيق لعرض خيارات المنصة.

3. أدخِل معرّف حزمة تطبيقك في حقل معرّف الحزمة.

   ما هو معرّف الحزمة وأين يمكن العثور عليه؟

   • يحدّد معرّف الحزمة تطبيقًا بشكل فريد في منظومة Apple المتكاملة.

   • للعثور على معرّف الحزمة: افتح مشروعك في Xcode، واختَر التطبيق ذي المستوى الأعلى في مستكشف المشروع، ثم اختَر علامة التبويب عام.

     قيمة حقل معرّف الحزمة هي معرّف الحزمة (على سبيل المثال، com.yourcompany.yourproject).

   • يُرجى العِلم أنّ قيمة معرّف الحزمة حسّاسة لحالة الأحرف، ولا يمكن تغييرها لتطبيق Firebase هذا بعد تسجيله في مشروع Firebase.

4. (اختياري) أدخِل معلومات التطبيق الأخرى: اسم التطبيق ورقم تعريف App Store.

   كيف يتم استخدام الاسم المعرِّف للتطبيق ورقم تعريف App Store في Firebase؟

   • اسم التطبيق: معرّف داخلي مريح لا يظهر إلا لك في وحدة تحكّم Firebase

   • معرّف متجر التطبيقات: يستخدمه Firebase Dynamic Links لإعادة توجيه المستخدمين إلى صفحة متجر التطبيقات ويستخدمه Google Analytics لاستيراد أحداث الإحالات الناجحة إلى Google Ads. إذا لم يكن تطبيقك يحتوي على معرّف App Store حتى الآن، يمكنك إضافة المعرّف لاحقًا في إعدادات المشروع.

5. انقر على تسجيل التطبيق.

الخطوة 3: إضافة ملف إعداد Firebase

1. انقر على تنزيل GoogleService-Info.plist للحصول على ملف إعداد Firebase الخاص بتطبيقك (GoogleService-Info.plist).

   ما الذي يجب معرفته عن ملف الإعداد هذا؟

   • يحتوي ملف إعداد Firebase على معرّفات فريدة، ولكنها غير سرية، لمشروعك وتطبيقك. لمزيد من المعلومات حول ملف الإعداد هذا، يُرجى الانتقال إلى فهم مشاريع Firebase.

   • يمكنك تنزيل ملف إعدادات Firebase مجددًا في أي وقت.

   • تأكَّد من عدم إلحاق أحرف إضافية باسم ملف الإعداد، مثل (2).

2. انقل ملف الإعداد إلى جذر مشروع Xcode. إذا طُلب منك ذلك، اختَر إضافة ملف الإعداد إلى جميع الأهداف.

إذا كان لديك عدة معرّفات حِزم في مشروعك، يجب ربط كل معرّف حزمة بتطبيق مسجَّل في وحدة تحكّم "Firebase" لكي يكون لكل تطبيق ملف "GoogleService-Info.plist" خاص به.

الخطوة 4: إضافة حِزم تطوير البرامج (SDK) لمنصّة Firebase إلى تطبيقك

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

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

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

3. اختَر إصدار حزمة SDK الذي تريد استخدامه.

4. اختَر مكتبات Firebase التي تريد استخدامها.

   إذا كان Google Analytics مفعَّلاً في مشروعك على Firebase، تأكَّد من إضافة FirebaseAnalytics. ويوفّر ذلك جميع ميزات الإحصاءات. يمكنك أيضًا اختيار ميزات فردية. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول أحدث تنظيم للوحدات في حزمة تطوير البرامج (SDK) لـ Google Analytics في Firebase.

بعد الانتهاء، سيبدأ Xcode تلقائيًا في حلّ التبعيات وتنزيلها في الخلفية.

الخطوة 5: إعداد 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. إذا كنت قد ضمّنت حزمة تطوير البرامج (SDK) لمنصّة Firebase في Google Analytics، يمكنك تشغيل تطبيقك لإرسال إثبات إلى وحدة تحكّم Firebase بأنّك ثبّتّ Firebase بنجاح.

وهذا كل ما في الأمر! يمكنك الانتقال إلى الخطوات التالية.

إذا واجهت مشكلة في الإعداد، يمكنك الانتقال إلى تحديد المشاكل وحلّها والأسئلة الشائعة حول منصات Apple.

المكتبات المتاحة

يسرد هذا القسم منتجات Firebase المتوافقة مع أنظمة Apple الأساسية. مزيد من المعلومات عن مكتبات Firebase لمنصات Apple:

• المستندات المرجعية (Swift | Obj-C)

• مستودع GitHub لحزمة تطوير البرامج (SDK) الخاصة بمنصات Firebase Apple

الخدمة أو المنتج	اسم المكتبة أو إطار العمل	هل تريد إضافة "إحصاءات Google"؟
AdMob	GoogleMobileAds
Firebase AI Logic 1	FirebaseAILogic
Analytics	FirebaseAnalytics
App Check	FirebaseAppCheck
App Distribution	FirebaseAppDistribution
Authentication	FirebaseAuth
Cloud Firestore	FirebaseFirestore
Cloud Functions for Firebase Client SDK	FirebaseFunctions
Cloud Messaging	FirebaseMessaging
Cloud Storage	FirebaseStorage
Crashlytics	FirebaseCrashlytics
In-App Messaging	FirebaseInAppMessaging	(مطلوب)
عمليات تثبيت بقيمة ‎Firebase	FirebaseInstallations
Performance Monitoring	FirebasePerformance
Realtime Database	FirebaseDatabase
Remote Config	FirebaseRemoteConfig
SQL Connect 2	FirebaseDataConnect
المكتبات المتوقفة نهائيًا أو غير المتوافقة
Dynamic Links	FirebaseDynamicLinks
واجهتا برمجة تطبيقات (Firebase ML) للنماذج المخصّصة	FirebaseMLModelDownloader

^{1 Firebase AI Logic (FirebaseAILogic) كان يُعرف سابقًا باسم "Vertex AI في Firebase" وتم توزيعه ضمن وحدة FirebaseVertexAI. Firebase AI Logic كان يتم توزيعه سابقًا ضمن وحدة FirebaseAI.}

^{2 كانت "Firebase SQL Connect" تُعرف سابقًا باسم "Firebase Data Connect".}

الدمج بدون استخدام Swift Package Manager

إذا كنت لا تريد استخدام Swift Package Manager، سيظلّ بإمكانك دمج Firebase من خلال استيراد أُطر العمل المُجمَّعة مسبقًا مباشرةً.

أُطر العمل

بالإضافة إلى دعم نظام iOS الأساسي، يتضمّن ملف ZIP الآن ملفات .xcframework. لمزيد من التفاصيل، يُرجى الاطّلاع على ملف README الخاص بحزمة تطوير البرامج (SDK) لمنصات Apple من Firebase على GitHub.

1. نزِّل ملف ZIP الخاص بحزمة تطوير البرامج (SDK) لإطار العمل. يبلغ حجم هذا الملف حوالي 200 ميغابايت، وقد تستغرق عملية تنزيله بعض الوقت.

2. فكّ ضغط الملف، ثم ادمج أُطر العمل التي تريد تضمينها في تطبيقك.

   يمكنك العثور على تعليمات الدمج في أيّ من المكانَين التاليَين:

   • في مستودع GitHub لحزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Firebase.
   • في ملف README.md ضمن ملف ZIP الذي تم تنزيله

   للحصول على معلومات حول إصدارات إطار العمل أو التبعيات، يُرجى الرجوع إلى ملف METADATA.md ضمن توزيعة zip التي تم تنزيلها.

3. أضِف علامة الرابط -ObjC في Other Linker Flags في إعدادات الإنشاء الخاصة بالهدف.

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

مزيد من المعلومات عن Firebase:

• انتقِل إلى مقالة فهم مشاريع Firebase لمزيد من المعلومات عن مشاريع Firebase وأفضل الممارسات المتعلّقة بها.

• استكشِف نماذج تطبيقات Firebase.

• يمكنك الحصول على خبرة عملية من خلال الدرس التطبيقي حول الترميز في Firebase iOS.

• يمكنك الاطّلاع على الرمز المفتوح المصدر في GitHub.

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

  • يمكنك إعداد تنبيهات بشأن الميزانية لمشروعك في وحدة تحكّم Google Cloud.
  • يمكنك مراقبة لوحة بيانات الاستخدام والفوترة في وحدة تحكّم Firebase للحصول على نظرة عامة على استخدام مشروعك في خدمات Firebase المتعدّدة.
  • راجِع قائمة التحقّق من إطلاق Firebase.

• هل تواجه مشكلة في Firebase ومشروع Apple؟ يُرجى الانتقال إلى الأسئلة الشائعة حول تحديد المشاكل وحلّها في منصات Apple.

إضافة خدمات Firebase إلى تطبيقك:

• يمكنك إنشاء ميزات مستندة إلى الذكاء الاصطناعي التوليدي باستخدام نماذج Gemini من خلال Firebase AI Logic.

• يمكنك الحصول على إحصاءات حول سلوك المستخدمين من خلال Analytics.

• إعداد مصادقة المستخدم باستخدام Authentication

• تخزين البيانات، مثل معلومات المستخدم، باستخدام Cloud Firestore أو Realtime Database

• يمكنك تخزين الملفات، مثل الصور والفيديوهات، باستخدام Cloud Storage.

• يمكنك تفعيل الرمز البرمجي في الخلفية الذي يتم تشغيله في بيئة آمنة باستخدام Cloud Functions.

• إرسال الإشعارات باستخدام Cloud Messaging

• يمكنك معرفة وقت تعطُّل تطبيقك وسبب ذلك باستخدام Crashlytics.