المتطلبات الأساسية
قم بتثبيت ما يلي:
- Xcode 14.1 أو الأحدث
تأكد من أن مشروعك يلبي هذه المتطلبات:
- يجب أن يستهدف مشروعك إصدارات النظام الأساسي هذه أو الإصدارات الأحدث:
- دائرة الرقابة الداخلية 11
- ماك 10.13
- تي في او اس 12
- واتش او اس 6
- يجب أن يستهدف مشروعك إصدارات النظام الأساسي هذه أو الإصدارات الأحدث:
قم بإعداد جهاز Apple فعلي أو استخدم جهاز محاكاة لتشغيل تطبيقك.
بالنسبة للمراسلة السحابية على أنظمة Apple الأساسية، إليك المتطلبات الأساسية:
- قم بإعداد جهاز Apple فعلي .
- احصل على مفتاح مصادقة إشعارات Apple Push لحساب Apple Developer الخاص بك.
- قم بتمكين الإشعارات الفورية في Xcode ضمن التطبيق > القدرات .
- قم بتسجيل الدخول إلى Firebase باستخدام حساب Google الخاص بك.
إذا لم يكن لديك مشروع Xcode بالفعل وتريد فقط تجربة أحد منتجات Firebase، فيمكنك تنزيل أحد نماذج البدء السريع الخاصة بنا.
الخطوة 1 : إنشاء مشروع Firebase
قبل أن تتمكن من إضافة Firebase إلى تطبيق Apple الخاص بك، تحتاج إلى إنشاء مشروع Firebase للاتصال بتطبيقك. قم بزيارة فهم مشاريع Firebase لمعرفة المزيد حول مشاريع Firebase.
الخطوة 2 : قم بتسجيل تطبيقك في Firebase
لاستخدام Firebase في تطبيق Apple الخاص بك، يتعين عليك تسجيل تطبيقك في مشروع Firebase الخاص بك. غالبًا ما يُطلق على تسجيل تطبيقك اسم "إضافة" تطبيقك إلى مشروعك.
انتقل إلى وحدة تحكم Firebase .
في وسط صفحة النظرة العامة على المشروع، انقر فوق أيقونة iOS+ لبدء سير عمل الإعداد.
إذا قمت بالفعل بإضافة تطبيق إلى مشروع Firebase الخاص بك، فانقر على إضافة تطبيق لعرض خيارات النظام الأساسي.
أدخل معرف حزمة التطبيق الخاص بك في حقل معرف الحزمة .
يحدد معرف الحزمة بشكل فريد التطبيق في نظام Apple البيئي.
ابحث عن معرف الحزمة الخاصة بك: افتح مشروعك في Xcode، وحدد تطبيق المستوى الأعلى في متصفح المشروع، ثم حدد علامة التبويب عام .
قيمة حقل معرف الحزمة هي معرف الحزمة (على سبيل المثال،
com.yourcompany.yourproject
).انتبه إلى أن قيمة معرف الحزمة حساسة لحالة الأحرف، ولا يمكن تغييرها لتطبيق Firebase هذا بعد تسجيله في مشروع Firebase الخاص بك.
(اختياري) أدخل معلومات التطبيق الأخرى: لقب التطبيق ومعرف متجر التطبيقات .
لقب التطبيق : معرف داخلي ملائم لا يظهر إلا لك في وحدة تحكم Firebase
معرف متجر التطبيقات : يستخدمه Firebase Dynamic Links لإعادة توجيه المستخدمين إلى صفحة متجر التطبيقات لديك ويستخدمه Google Analytics لاستيراد أحداث التحويل إلى إعلانات Google . إذا لم يكن لتطبيقك معرف App Store حتى الآن، فيمكنك إضافة المعرف لاحقًا في إعدادات المشروع .
انقر فوق تسجيل التطبيق .
الخطوة 3 : إضافة ملف تكوين Firebase
انقر فوق Download GoogleService-Info.plist للحصول على ملف تكوين منصات Firebase Apple (
GoogleService-Info.plist
).يحتوي ملف تكوين Firebase على معرفات فريدة ولكنها غير سرية لمشروعك. لمعرفة المزيد حول ملف التكوين هذا، قم بزيارة فهم مشاريع Firebase .
يمكنك تنزيل ملف تهيئة Firebase مرة أخرى في أي وقت.
تأكد من عدم إلحاق اسم ملف التكوين بأحرف إضافية، مثل
(2)
.
انقل ملف التكوين الخاص بك إلى جذر مشروع Xcode الخاص بك. إذا طُلب منك ذلك، حدد إضافة ملف التكوين إلى كافة الأهداف.
إذا كان لديك معرفات حزمة متعددة في مشروعك، فيجب عليك ربط كل معرف حزمة بتطبيق مسجل في وحدة تحكم Firebase حتى يتمكن كل تطبيق من الحصول على ملف GoogleService-Info.plist
الخاص به.
الخطوة 4 : أضف حزم Firebase SDK إلى تطبيقك
استخدم Swift Package Manager لتثبيت تبعيات Firebase وإدارتها.
- في Xcode، مع فتح مشروع التطبيق الخاص بك، انتقل إلى File > Add Packages .
- عندما يُطلب منك ذلك، قم بإضافة مستودع Firebase Apple الأساسي لـ SDK:
- حدد إصدار SDK الذي تريد استخدامه.
اختر مكتبات Firebase التي تريد استخدامها.
إذا تم تمكين Google Analytics في مشروع Firebase الخاص بك، فتأكد من إضافة
FirebaseAnalytics
. بالنسبة إلى Analytics التي لا تتمتع بإمكانية جمع 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 // ...
سويفت
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
ج موضوعية
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- قم بتكوين مثيل
FirebaseApp
مشترك في طريقةapplication(_:didFinishLaunchingWithOptions:)
:سويفتويي
// Use Firebase library to configure APIs FirebaseApp.configure()
سويفت
// Use Firebase library to configure APIs FirebaseApp.configure()
ج موضوعية
// Use Firebase library to configure APIs [FIRApp configure];
- إذا كنت تستخدم SwiftUI، فيجب عليك إنشاء مفوض تطبيق وإرفاقه ببنية
App
الخاص بك عبرUIApplicationDelegateAdaptor
أوNSApplicationDelegateAdaptor
. يجب عليك أيضًا تعطيل swizzling مندوب التطبيق. لمزيد من المعلومات، راجع تعليمات SwiftUI .سويفتويي
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- إذا قمت بتضمين Firebase SDK لبرنامج Google Analytics، فيمكنك تشغيل تطبيقك لإرسال التحقق إلى وحدة تحكم Firebase بأنك قمت بتثبيت Firebase بنجاح.
هذا كل شيء! يمكنك التخطي للأمام إلى الخطوات التالية .
إذا كنت تواجه مشكلة في الإعداد، فتفضل بزيارة استكشاف أخطاء أنظمة Apple الأساسية وإصلاحها والأسئلة الشائعة .
المكتبات المتوفرة
يسرد هذا القسم منتجات Firebase المدعومة لأنظمة Apple الأساسية. تعرف على المزيد حول مكتبات منصة Firebase Apple هذه:
منصات Firebase Apple SDK GitHub repo
الخدمة أو المنتج | القرون | مكتبات SwiftPM | إضافة تحليلات؟ |
---|---|---|---|
ادموب | pod 'Google-Mobile-Ads-SDK' | لا يوجد | |
التحليلات | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
فحص التطبيق | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
توزيع التطبيق | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
المصادقة | pod 'FirebaseAuth' | FirebaseAuth | |
سحابة فايرستور | pod 'FirebaseFirestore' | FirebaseFirestore | |
وظائف السحابة لـ Firebase Client SDK | pod 'FirebaseFunctions' | FirebaseFunctions | |
المراسلة السحابية | pod 'FirebaseMessaging' | FirebaseMessaging | |
سحابة التخزين | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
الروابط الديناميكية | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
المراسلة داخل التطبيق | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (مطلوب) |
منشآت Firebase | pod 'FirebaseInstallations' | FirebaseInstallations | |
واجهات برمجة التطبيقات للنموذج المخصص لـ Firebase ML | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
مراقبة الاداء | pod 'FirebasePerformance' | FirebasePerformance | |
قاعدة بيانات الوقت الحقيقي | pod 'FirebaseDatabase' | FirebaseDatabase | |
التكوين عن بعد | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
التكامل دون استخدام Swift Package Manager
إذا كنت لا ترغب في استخدام Swift Package Manager، فلا يزال بإمكانك الاستفادة من Firebase SDKs باستخدام CocoaPods أو عن طريق استيراد أطر العمل مباشرةً.
كاكاوبودس
تعرف على المزيد حول تكامل CocoaPods في دليلنا .
إطار أعمال
بالإضافة إلى دعم نظام التشغيل iOS، يتضمن الملف المضغوط الآن ملفات .xcframework
. للحصول على التفاصيل، راجع الملف التمهيدي لـ SDK الخاص بأنظمة Firebase Apple على GitHub .
قم بتنزيل إطار عمل SDK zip . يبلغ حجم هذا الملف حوالي 200 ميجابايت وقد يستغرق تنزيله بعض الوقت.
قم بفك ضغط الملف، ثم قم بدمج الإطارات التي تريد تضمينها في تطبيقك.
يمكنك العثور على تعليمات التكامل في أي من الأماكن التالية:
- في مستودع Firebase iOS SDK GitHub .
- في ملف
README.md
ضمن التوزيعة المضغوطة التي تم تنزيلها.
للحصول على معلومات بخصوص إصدارات إطار العمل أو تبعياته، راجع ملف
METADATA.md
ضمن التوزيع المضغوط الذي تم تنزيله.أضف علامة رابط
-ObjC
فيOther Linker Settings
في إعدادات إنشاء هدفك.
الخطوات التالية
تعرف على Firebase:
قم بزيارة فهم مشاريع Firebase للتعرف على المزيد حول مشاريع Firebase وأفضل الممارسات الخاصة بالمشاريع.
استكشف نماذج من تطبيقات Firebase .
احصل على خبرة عملية مع Firebase iOS Codelab .
الاستعداد لإطلاق تطبيقك:
- قم بإعداد تنبيهات الميزانية لمشروعك في Google Cloud Console.
- راقب لوحة تحكم الاستخدام والفوترة في وحدة تحكم Firebase للحصول على صورة شاملة لاستخدام مشروعك عبر خدمات Firebase المتعددة.
- قم بمراجعة القائمة المرجعية لإطلاق Firebase .
هل تواجه مشكلة مع Firebase ومشروع Apple الخاص بك؟ قم بزيارة استكشاف الأخطاء وإصلاحها والأسئلة الشائعة الخاصة بمنصات Apple .
أضف خدمات Firebase إلى تطبيقك:
احصل على رؤى حول سلوك المستخدم باستخدام Analytics .
قم بإعداد مصادقة المستخدم باستخدام المصادقة .
قم بتخزين البيانات، مثل معلومات المستخدم، باستخدام Cloud Firestore أو Realtime Database .
قم بتخزين الملفات، مثل الصور ومقاطع الفيديو، باستخدام Cloud Storage .
تشغيل كود الواجهة الخلفية الذي يتم تشغيله في بيئة آمنة باستخدام Cloud Functions .
إرسال الإخطارات مع خدمة المراسلة السحابية .
اكتشف متى ولماذا يتعطل تطبيقك مع Crashlytics .