Check out what’s new from Firebase at Google I/O 2022. Learn more

أضف Firebase إلى مشروع Apple الخاص بك

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

  • قم بتثبيت ما يلي:

    • Xcode 13.3.1 أو أحدث

  • تأكد من أن مشروعك يلبي هذه المتطلبات:

    • يجب أن يستهدف مشروعك إصدارات النظام الأساسي هذه أو أحدث:
      • iOS 10
      • نظام التشغيل macOS 10.12
      • tvOS 12
      • watchOS 6

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

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

الخطوة 1 : أنشئ مشروع Firebase

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

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

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

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

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

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

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

  4. (اختياري) أدخل معلومات التطبيق الأخرى: لقب التطبيق ومعرف متجر التطبيقات .

  5. انقر فوق تسجيل التطبيق .

الخطوة 3 : أضف ملف تكوين Firebase

  1. انقر فوق تنزيل GoogleService-Info.plist للحصول على ملف تهيئة أنظمة تشغيل Firebase Apple ( GoogleService-Info.plist ).

  2. انقل ملف التكوين الخاص بك إلى جذر مشروع Xcode الخاص بك. إذا طُلب منك ذلك ، فحدد لإضافة ملف التكوين إلى كافة الأهداف.

إذا كان لديك عدة معرّفات حِزمة في مشروعك ، فيجب عليك إقران معرّف كل حزمة بتطبيق مسجل في وحدة تحكم Firebase بحيث يمكن أن يكون لكل تطبيق ملف GoogleService-Info.plist الخاص به.

الخطوة 4 : أضف حزم Firebase SDK إلى تطبيقك

استخدم Swift Package Manager لتثبيت وإدارة تبعيات Firebase.

  1. في Xcode ، مع فتح مشروع التطبيق الخاص بك ، انتقل إلى ملف> إضافة حزم .
  2. عند المطالبة ، قم بإضافة مستودع SDK لأنظمة Firebase Apple الأساسية:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. حدد إصدار SDK الذي تريد استخدامه.

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

    إذا تم تمكين Google Analytics في مشروع Firebase ، فتأكد من إضافة FirebaseAnalytics . بالنسبة إلى Analytics بدون إمكانية جمع IDFA ، أضف FirebaseAnalyticsWithoutAdId بدلاً من ذلك.

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

الخطوة 5 : تهيئة Firebase في تطبيقك

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

  1. قم باستيراد وحدة FirebaseCore في مندوب UIApplicationDelegate ، بالإضافة إلى أي وحدات Firebase أخرى يستخدمها مفوض التطبيق. على سبيل المثال ، لاستخدام Cloud Firestore والمصادقة:

    سويفت

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    ج موضوعية

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. هيئ مثيل FirebaseApp المشترك ، عادةً في تطبيق تطبيقك application:didFinishLaunchingWithOptions: method:

    سويفت

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    ج موضوعية

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. إذا قمت بتضمين Firebase SDK لـ Google Analytics ، فيمكنك تشغيل تطبيقك لإرسال التحقق إلى وحدة تحكم Firebase بأنك قمت بتثبيت Firebase بنجاح.

هذا هو! يمكنك الانتقال إلى الخطوات التالية .

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

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

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

الخدمة أو المنتج القرون مكتبات SwiftPM إضافة تحليلات؟
AdMob pod 'Google-Mobile-Ads-SDK' غير متاح
تحليلات pod 'FirebaseAnalytics' FirebaseAnalytics
التحقق من التطبيق pod 'FirebaseAppCheck' FirebaseAppCheck
توزيع التطبيق pod 'FirebaseAppDistribution' FirebaseAppDistribution
المصادقة pod 'FirebaseAuth' FirebaseAuth
سحابة Firestore pod 'FirebaseFirestore' FirebaseFirestore
وظائف السحابة لـ Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
المراسلة السحابية pod 'FirebaseMessaging' FirebaseMessaging
سحابة التخزين pod 'FirebaseStorage' FirebaseStorage
كراشليتيك 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 ، فلا يزال بإمكانك الاستفادة من Firebase SDKs عن طريق استيراد الإطارات مباشرة أو باستخدام CocoaPods.

إطار أعمال

بالإضافة إلى دعم نظام iOS الأساسي ، فإن ملف zip يشتمل الآن على ملفات .xcframework . للحصول على التفاصيل ، راجع Firebase Apple platform SDK README على GitHub .

  1. قم بتنزيل إطار SDK zip . هذا ملف ~ 200 ميغا بايت وقد يستغرق بعض الوقت للتنزيل.

  2. قم بفك ضغط الملف ، ثم قم بمراجعة README للأطر التي تريد تضمينها في تطبيقك.

  3. أضف علامة رابط -ObjC في Other Linker Settings في إعدادات بناء الهدف.

CocoaPods

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

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

تعرف على Firebase:

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

  • احصل على رؤى حول سلوك المستخدم باستخدام Analytics .

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

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

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

  • تشغيل رمز الواجهة الخلفية الذي يعمل في بيئة آمنة باستخدام وظائف السحابة .

  • إرسال الإخطارات مع Cloud Messaging .

  • اكتشف متى ولماذا يتعطل تطبيقك مع Crashlytics .