المتطلبات الأساسية
ثبِّت ما يلي:
- الإصدار 26.2 من Xcode أو الإصدارات الأحدث
تأكَّد من أنّ مشروعك يستوفي المتطلبات التالية:
- يجب أن يستهدف مشروعك إصدارات المنصات التالية أو الإصدارات الأحدث:
- iOS 15
- الإصدار 11 من نظام التشغيل macOS
- tvOS 15
- watchOS 8
- يجب أن يستهدف مشروعك إصدارات المنصات التالية أو الإصدارات الأحدث:
اضبط جهاز Apple فعليًا أو استخدِم محاكيًا لتشغيل تطبيقك.
إذا لم يكن لديك مشروع Xcode وتريد فقط تجربة أحد منتجات Firebase، يمكنك تنزيل أحد نماذج البدء السريع.
الخطوة 1: إنشاء مشروع Firebase
قبل إضافة Firebase إلى تطبيق Apple، عليك إنشاء مشروع على Firebase لربطه بتطبيقك. يمكنك الاطّلاع على مقالة فهم مشاريع Firebase لمعرفة المزيد عن مشاريع Firebase.
الخطوة 2: تسجيل تطبيقك في Firebase
لاستخدام Firebase في تطبيق Apple، عليك تسجيل تطبيقك في مشروع Firebase. غالبًا ما يُطلق على تسجيل تطبيقك اسم "إضافة" تطبيقك إلى مشروعك.
انتقِل إلى وحدة تحكّم Firebase.
في وسط صفحة "نظرة عامة على المشروع"، انقر على رمز iOS+ لبدء عملية الإعداد.
إذا سبق لك إضافة تطبيق إلى مشروعك على Firebase، انقر على إضافة تطبيق لعرض خيارات المنصّة.
أدخِل معرّف حزمة تطبيقك في حقل معرّف الحزمة.
(اختياري) أدخِل معلومات التطبيق الأخرى: الاسم المعرِّف للتطبيق والمعرِّف في App Store.
انقر على تسجيل التطبيق (Register app).
الخطوة 3: إضافة ملف إعداد Firebase
انقر على تنزيل GoogleService-Info.plist للحصول على ملف إعداد Firebase الخاص بتطبيقك (
GoogleService-Info.plist).انقل ملف الإعداد إلى جذر مشروع Xcode. إذا طُلب منك ذلك، اختَر إضافة ملف الإعداد إلى جميع الأهداف.
إذا كانت لديك عدة معرّفات حِزم في مشروعك، عليك ربط كل معرّف حزمة بتطبيق مسجَّل في وحدة تحكّم "Firebase" لكي يكون لكل تطبيق ملف "GoogleService-Info.plist" خاص به.
الخطوة 4: إضافة حِزم تطوير البرامج (SDK) لمنصّة Firebase إلى تطبيقك
استخدِم Swift Package Manager لتثبيت تبعيات Firebase وإدارتها.
- في Xcode، افتح مشروع تطبيقك، ثم انتقِل إلى ملف > إضافة حِزم (File > Add Packages).
- عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لمنصات Apple في Firebase:
- اختَر إصدار حزمة تطوير البرامج (SDK) الذي تريد استخدامه.
اختَر مكتبات Firebase التي تريد استخدامها.
إذا كانت ميزة "Google Analytics" مفعَّلة في مشروع Firebase، تأكَّد من إضافة
FirebaseAnalytics. ويوفّر ذلك جميع ميزات الإحصاءات. يمكنك أيضًا اختيار ميزات فردية. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول أحدث تنظيم للوحدات في حزمة تطوير البرامج (SDK) لمنصة Google Analytics لبرنامج Firebase.
https://github.com/firebase/firebase-ios-sdk
بعد الانتهاء، سيبدأ Xcode تلقائيًا في حلّ التبعيات وتنزيلها في الخلفية.
الخطوة 5: إعداد Firebase في تطبيقك
الخطوة الأخيرة هي إضافة رمز الإعداد إلى تطبيقك. قد تكون أكملت هذه الخطوة كجزء من عملية إضافة Firebase إلى تطبيقك. إذا كنت تستخدم مشروعًا نموذجيًا للبدء السريع، فقد تم إكمال هذه الخطوة نيابةً عنك.
- استورِد وحدة
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; // ...
- اضبط مثيلاً مشتركًا من
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];
- إذا كنت تستخدم 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() } } } }
- إذا كنت قد ضمّنت حزمة تطوير البرامج (SDK) لمنصّة Firebase في Google Analytics، يمكنك تشغيل تطبيقك لإرسال إثبات إلى وحدة تحكّم Firebase بأنّك ثبّتّ Firebase بنجاح.
وهذا كل ما في الأمر! يمكنك تخطّي هذه الخطوة والانتقال إلى الخطوات التالية.
إذا واجهت مشكلة في الإعداد، يمكنك الانتقال إلى الأسئلة الشائعة وتحديد المشاكل وحلّها في منصات Apple.
المكتبات المتاحة
يسرد هذا القسم منتجات Firebase المتوافقة مع أنظمة Apple الأساسية. مزيد من المعلومات عن مكتبات Firebase لمنصات Apple:
مستودع 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.
نزِّل ملف ZIP لحزمة تطوير البرامج (SDK) لإطار العمل. يبلغ حجم هذا الملف حوالي 200 ميغابايت، وقد يستغرق تنزيله بعض الوقت.
فكّ ضغط الملف، ثم ادمج أُطر العمل التي تريد تضمينها في تطبيقك.
يمكنك العثور على تعليمات الدمج في أيّ من المكانَين التاليَين:
- في مستودع GitHub لحزمة تطوير البرامج (SDK) لنظام التشغيل iOS في Firebase.
- في ملف
README.mdضمن ملف ZIP الذي تم تنزيله
للحصول على معلومات حول إصدارات إطار العمل أو التبعيات، يُرجى الرجوع إلى ملف
METADATA.mdضمن توزيعة zip التي تم تنزيلها.أضِف علامة الرابط
-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.