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

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

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

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

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

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

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

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

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

  • إعداد جهاز Apple
  • احصل على مفتاح مصادقة خدمة الإشعارات الفورية في Apple لحسابك على Apple Developer.
  • فعِّل الإشعارات الفورية في 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 console.

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

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

1. سجِّل الدخول إلى Firebase console باستخدام الحساب الذي يمنحك إذن الوصول إلى مشروع 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 console.

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

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

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

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

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

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

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

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

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

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

   • يُرجى العِلم أنّ قيمة معرّف الحزمة حسّاسة لحالة الأحرف، ولا يمكن تغييرها لتطبيق 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 وإدارتها.

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

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

3. اختَر إصدار حزمة تطوير البرامج (SDK) الذي تريد استخدامه.

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

   إذا كانت Google Analytics مفعّلة في مشروعك على Firebase، تأكَّد من إضافة FirebaseAnalytics. يوفّر ذلك جميع ميزات "إحصاءات Google". يمكنك أيضًا اختيار ميزات فردية. لمزيد من المعلومات، اطّلِع على الأسئلة الشائعة حول أحدث تنظيم للوحدات في Google Analytics لحزمة تطوير البرامج (SDK) لمنصة 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. يمكنك الاطّلاع على مزيد من المعلومات عن مكتبات منصة Apple في Firebase:

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

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

الخدمة أو المنتج	اسم المكتبة أو إطار العمل	إضافة "إحصاءات 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 على 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.