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

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

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

  • ‫Xcode 16.2 أو إصدار أحدث

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

  • يجب أن يستهدف مشروعك إصدارات النظام الأساسي هذه أو إصدارات أحدث:
    • ‫iOS 13
    • ‫macOS 10.15
    • tvOS 13
    • ‫watchOS 7

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

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

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

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

• سجِّل الدخول إلى Firebase باستخدام حسابك على Google.

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

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

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

إنشاء مشروع على Firebase

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

   • لإضافة موارد Firebase إلى مشروع حالي، أدخِل اسم المشروع أو اختَره من القائمة المنسدلة.Google Cloud

   • لإنشاء مشروع جديد، أدخِل اسم مشروع. يمكنك أيضًا تعديل رقم تعريف المشروع المعروض أسفل اسم المشروع.

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

2. راجِع بنود Firebase واقبلها إذا طُلب منك ذلك.

3. انقر على متابعة.

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

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

   يمكنك إعداد Google Analytics لاحقًا في علامة التبويب عمليات الدمج ضمن إعدادات المشروع.

5. انقر على إنشاء مشروع (أو إضافة Firebase، إذا كنت تضيف Firebase إلى مشروع Google Cloud حالي).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   • رقم تعريف App Store: تستخدمه Firebase Dynamic Links من أجل إعادة توجيه المستخدمين إلى صفحتك على App Store، وتستخدمه 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 وإدارتها.

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

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

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

3. اختَر إصدار حزمة تطوير البرامج (SDK) الذي تريد استخدامه.
   ملاحظة: ننصح باستخدام إصدار حزمة SDK التلقائي (الأحدث)، ولكن يمكنك اختيار إصدار أقدم إذا لزم الأمر.

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

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

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

الخطوة 5: إعداد Firebase في تطبيقك

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

ملاحظة: لتسهيل صيانة مستندات منصات Apple، قرّر فريق Firebase التركيز على مقتطفات Swift ونماذج الرموز في أدلتنا ومواد المطوّرين الأخرى. ستتم إزالة مقتطفات Objective-C من أدلتنا اعتبارًا من 1 يناير 2024. سنواصل توفير مستندات مرجعية محدّثة لـ Objective-C لجميع منتجات 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.

ملاحظة: إذا كنت تستهدف نظام التشغيل macOS أو macOS Catalyst، يجب إضافة إمكانية مشاركة سلسلة المفاتيح إلى هدفك. في Xcode، انتقِل إلى علامة التبويب التوقيع والقدرات الخاصة بالهدف، ثم انقر على + القدرات لإضافة قدرة جديدة.

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

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

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

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

بالنسبة إلى التطبيقات التي تستخدم CocoaPods، تم إيقاف Firebase pod نهائيًا في الإصدار 9.0 والإصدارات الأحدث. بدلاً من ذلك، عليك الرجوع إلى حِزم المنتجات مباشرةً في ملف Podfile (على سبيل المثال، FirebaseCore بدلاً من Firebase/Core وFirebaseFirestore بدلاً من Firebase/Firestore).

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

^{1 كان اسم Firebase AI Logic في السابق "Vertex AI in Firebase" مع الحزمة pod 'FirebaseVertexAI' ومكتبة SwiftPM FirebaseVertexAI.}

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

إذا كنت لا تريد استخدام Swift Package Manager، سيظل بإمكانك الاستفادة من حِزم تطوير البرامج (SDK) من Firebase باستخدام CocoaPods أو من خلال استيراد الأُطر مباشرةً.

CocoaPods

يمكنك الاطّلاع على مزيد من المعلومات حول دمج CocoaPods في دليلنا.

أُطر العمل

بالإضافة إلى توفير ملفات ZIP متوافقة مع نظام التشغيل 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 Settings في إعدادات الإصدار الخاص بالهدف.

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

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

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

• استكشاف تطبيقات Firebase النموذجية

• يمكنك الحصول على تجربة عملية من خلال مختبر الترميز لنظام التشغيل iOS في Firebase.

• استكشاف الرمز المصدري المفتوح في GitHub

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

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

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

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

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

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

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

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

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

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

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

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