المتطلّبات الأساسية
ثبِّت ما يلي:
- Xcode 14.1 أو إصدار أحدث
تأكد من أن مشروعك يلبي هذه المتطلبات:
- يجب أن يستهدف مشروعك إصدارات النظام الأساسي التالية أو الإصدارات الأحدث:
- الإصدار 11 من نظام التشغيل iOS
- الإصدار 10.13 من نظام التشغيل macOS
- نظام التشغيل tvOS 12
- ساعة تعمل بنظام التشغيل WatchOS 6
- يجب أن يستهدف مشروعك إصدارات النظام الأساسي التالية أو الإصدارات الأحدث:
يمكنك إعداد جهاز Apple فعلي أو استخدام محاكي لتشغيل تطبيقك.
- سجّل الدخول إلى Firebase باستخدام حسابك على Google.
إذا لم يكن لديك مشروع Xcode من قبل وتريد فقط تجربة أحد منتجات Firebase، يمكنك تنزيل أحد نماذج البدء السريع.
الخطوة 1: إنشاء مشروع على Firebase
قبل أن تتمكّن من إضافة Firebase إلى تطبيق Apple، يجب إنشاء مشروع في Firebase لربطه بتطبيقك. انتقِل إلى فهم مشاريع Firebase للاطّلاع على مزيد من المعلومات حول مشاريع Firebase.
الخطوة 2: تسجيل تطبيقك في Firebase
لاستخدام Firebase في تطبيق Apple، يجب تسجيل تطبيقك في مشروع Firebase. غالبًا ما يطلق على تسجيل تطبيقك "إضافة" التطبيق إلى مشروعك.
انتقِل إلى وحدة تحكُّم Firebase.
في منتصف صفحة "نظرة عامة على المشروع"، انقر على الرمز +iOS لبدء عملية الإعداد.
إذا سبق وأضفت تطبيقًا إلى مشروع Firebase، انقر على إضافة تطبيق لعرض خيارات النظام الأساسي.
أدخِل معرّف حزمة التطبيق في الحقل معرّف الحزمة.
(اختياري) أدخِل معلومات التطبيق الأخرى: اسم التطبيق ورقم تعريف متجر التطبيقات.
انقر على تسجيل التطبيق.
الخطوة 3: إضافة ملف إعداد Firebase
انقر على تنزيل GoogleService-Info.plist للحصول على ملف إعداد Firebase Apple (
GoogleService-Info.plist
).انقل ملف التكوين إلى جذر مشروع Xcode. اختَر إضافة ملف الإعداد إلى جميع الاستهدافات إذا طُلب منك ذلك
إذا كان لديك عدّة معرّفات حِزم في مشروعك، عليك ربط كل رقم تعريف
بتطبيق مسجَّل في وحدة تحكُّم Firebase كي يكون لكل تطبيق
ملف GoogleService-Info.plist
خاص به.
الخطوة 4: إضافة حِزم تطوير البرامج (SDK) لمنصّة Firebase إلى تطبيقك
يمكنك استخدام "مدير حزم Swift" لتثبيت اعتماديات Firebase وإدارتها.
- في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى File > Add Packages (ملف > إضافة حِزم).
- أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple عندما يُطلب منك ذلك:
- اختَر إصدار حزمة تطوير البرامج (SDK) الذي تريد استخدامه.
اختَر مكتبات Firebase التي تريد استخدامها.
في حال تفعيل "إحصاءات Google" في مشروع Firebase، تأكّد من إضافة
FirebaseAnalytics
. وبالنسبة إلى "إحصاءات Google" التي لا توفّر إمكانية جمع معرّف المعلِنين (IDFA)، أضِفFirebaseAnalyticsWithoutAdId
بدلاً من ذلك.
https://github.com/firebase/firebase-ios-sdk
عند الانتهاء، ستبدأ خدمة Xcode تلقائيًا في حلّ المشاكل المتعلّقة بالعناصر التي تعتمد عليها وتنزيلها في الخلفية.
الخطوة 5: إعداد Firebase في تطبيقك
الخطوة الأخيرة هي إضافة رمز إعداد إلى تطبيقك. قد تكون سبق لك تنفيذ هذا الإجراء كجزء من إضافة Firebase إلى تطبيقك. وإذا كنت تستخدم نموذج مشروع للبدء السريع، يعني ذلك أنّ الأمر تم نيابةً عنك.
- يمكنك استيراد وحدة
FirebaseCore
فيUIApplicationDelegate
، بالإضافة إلى أي وحدات Firebase أخرى يستخدمها المستخدم المفوَّض في تطبيقك. على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:واجهة المستخدم
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- يمكنك ضبط المثيل المشترك ضمن
FirebaseApp
في طريقةapplication(_:didFinishLaunchingWithOptions:)
الخاصة بمفوَّض تطبيقك:واجهة المستخدم
// 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];
- إذا كنت تستخدم SwiftUI، عليك إنشاء تفويض تطبيق وإرفاقه
ببنية
App
من خلالUIApplicationDelegateAdaptor
أوNSApplicationDelegateAdaptor
. ويجب أيضًا إيقاف إيماءة تفويض التطبيق. لمزيد من المعلومات، راجِع تعليمات SwiftUI.واجهة المستخدم
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- في حال تضمين حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google"، يمكنك تشغيل تطبيقك لإرسال رسالة التحقّق إلى وحدة تحكُّم Firebase التي ثبَّتها بنجاح.
وهذا كل ما في الأمر! يمكنك التخطّي إلى الخطوات التالية.
إذا كنت تواجه مشكلة في الإعداد، يمكنك زيارة مقالة تحديد المشاكل وحلّها في أنظمة Apple الأساسية والأسئلة الشائعة حولها.
المكتبات المتاحة
يسرد هذا القسم منتجات Firebase المتوافقة مع أنظمة Apple الأساسية. اعرف المزيد من المعلومات عن مكتبات الأنظمة الأساسية لمنصّة Firebase Apple التالية:
مستودع GitHub لحزمة تطوير البرامج (SDK) لمنصّات Apple الأساسية من Firebase
الخدمة أو المنتج | اللوحات | مكتبات SwiftPM | هل تريد إضافة "إحصاءات Google"؟ |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
لا ينطبق | |
إحصاءات Google | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
فحص التطبيقات | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
توزيع التطبيقات | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
المصادقة | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
حزمة تطوير البرامج (SDK) الخاصة بإصدار Cloud Functions لبرنامج Firebase | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
المراسلة عبر السحابة الإلكترونية | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
التخزين في السحابة الإلكترونية | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
الروابط الديناميكية | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
المراسلة داخل التطبيق | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(مطلوب) |
عمليات تثبيت Firebase | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
واجهات برمجة التطبيقات للنماذج المخصّصة لتعلُّم الآلة من Firebase | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
مراقبة الأداء | pod 'FirebasePerformance' |
FirebasePerformance |
|
قاعدة بيانات الوقت الفعلي | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
الإعداد عن بُعد | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI لبرنامج Firebase | لا ينطبق | FirebaseVertexAI-Preview |
الدمج بدون استخدام أداة Swift Package Manager
إذا كنت لا تريد استخدام أداة Swift Package Manager، سيظل بإمكانك الاستفادة من حِزم تطوير البرامج (SDK) لمنصة Firebase من خلال استخدام CocoaPods أو استيراد أطر العمل مباشرةً.
CocoaPods
اطّلِع على مزيد من المعلومات عن عملية دمج CocoaPods في دليلنا.
أُطر العمل
بالإضافة إلى التوافق مع النظام الأساسي iOS، يتضمن ملف zip الآن
ملفات .xcframework
. ولمعرفة التفاصيل، يُرجى الاطّلاع على ملف README لحزمة تطوير البرامج (SDK)
لأنظمة Apple الأساسية من Firebase على
GitHub
.
نزِّل ملف ZIP لحزمة تطوير البرامج (SDK) لإطار العمل. يبلغ حجم هذا الملف 200 ميغابايت تقريبًا وقد يستغرق تنزيله بعض الوقت.
احرص على فك ضغط الملف، ثم دمج أطر العمل التي تريد تضمينها في تطبيقك.
يمكنك العثور على تعليمات الدمج في أيّ من الموضعَين التاليَين:
- في مستودع GitHub لحزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Firebase.
- في ملف
README.md
ضمن توزيع zip الذي تم تنزيله.
للحصول على معلومات حول إصدارات إطار العمل أو الملحقات، راجِع ملف
METADATA.md
ضمن توزيع zip الذي تم تنزيله.أضِف علامة رابط
-ObjC
فيOther Linker Settings
ضمن إعدادات إنشاء هدفك.
الخطوات اللاحقة
تعرَّف على Firebase:
انتقِل إلى قسم فهم مشاريع Firebase للاطّلاع على مزيد من المعلومات حول مشاريع Firebase وأفضل الممارسات للمشروعات.
استكشِف نماذج تطبيقات Firebase.
يمكنك الحصول على تجربة عملية من خلال الدرس التطبيقي حول ترميز iOS في Firebase.
استكشِف الرمز البرمجي مفتوح المصدر في GitHub.
الاستعداد لإطلاق تطبيقك:
- إعداد تنبيهات الميزانية لمشروعك في Google Cloud Console
- راقِب لوحة بيانات الاستخدام والفوترة في وحدة تحكُّم Firebase للحصول على صورة عامة عن استخدام مشروعك على عدّة خدمات في Firebase.
- راجِع قائمة التحقّق الخاصة بإطلاق Firebase.
هل تواجه مشكلة متعلقة بمنصة Firebase ومشروعك على Apple؟ انتقل إلى الأسئلة الشائعة حول أنظمة Apple الأساسية لتحديد المشاكل وحلّها.
إضافة خدمات Firebase إلى تطبيقك:
احصل على إحصاءات عن سلوك المستخدمين من خلال إحصاءات Google.
إعداد مصادقة المستخدم من خلال المصادقة
يمكنك تخزين البيانات، مثل معلومات المستخدم، باستخدام Cloud Firestore أو Realtime Database.
تخزين الملفات، مثل الصور والفيديوهات، باستخدام Cloud Storage
يمكنك تشغيل رمز الخلفية الذي يتم تشغيله في بيئة آمنة باستخدام دوال السحابة الإلكترونية.
ويمكنك إرسال الإشعارات باستخدام خدمة المراسلة عبر السحابة الإلكترونية.
تعرّف على وقت وأسباب تعطّل تطبيقك، وذلك باستخدام Crashlytics.