Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

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

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

الخطوة 1: إنشاء مشروع Firebase

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

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

بعد أن يكون لديك مشروع Firebase ، يمكنك إضافة تطبيق Apple إليه.

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

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

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

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

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

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

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

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

  1. انقر فوق تحميل GoogleService-Info.plist للحصول على الملف منصات Firebase أبل التكوين ( GoogleService-Info.plist ).

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

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

الخطوة 4: إضافة Firebase تطوير البرامج في تطبيقك

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

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

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

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

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

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

  1. استيراد وحدة Firebase في حياتك UIApplicationDelegate :

    سويفت

    import Firebase

    ج موضوعية

    @import Firebase;
  2. تكوين ل FirebaseApp المشتركة المثال، عادة في التطبيق الخاص بك application:didFinishLaunchingWithOptions: الأسلوب:

    سويفت

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

    ج موضوعية

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

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

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

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

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

الخدمة أو المنتج القرون مكتبات SwiftPM إضافة تحليلات؟
AdMob pod 'Google-Mobile-Ads-SDK' غير متاح
تحليلات pod 'Firebase/Analytics' FirebaseAnalytics
التحقق من التطبيق pod 'Firebase/AppCheck' FirebaseAppCheck
توزيع التطبيق pod 'Firebase/AppDistribution' FirebaseAppDistribution
المصادقة pod 'Firebase/Auth' FirebaseAuth
سحابة Firestore pod 'Firebase/Firestore' FirebaseFirestore
وظائف السحابة لـ Firebase Client SDK pod 'Firebase/Functions' FirebaseFunctions
المراسلة السحابية pod 'Firebase/Messaging' FirebaseMessaging
سحابة التخزين pod 'Firebase/Storage' FirebaseStorage
كراشليتيك pod 'Firebase/Crashlytics' FirebaseCrashlytics
روابط ديناميكية pod 'Firebase/DynamicLinks' FirebaseDynamicLinks
المراسلة داخل التطبيق pod 'Firebase/InAppMessaging' FirebaseInAppMessaging
(مطلوب)
منشآت Firebase pod 'Firebase/Installations' FirebaseInstallations
واجهات برمجة التطبيقات للنموذج المخصص لـ Firebase ML pod 'Firebase/MLModelDownloader' FirebaseMLModelDownloader
مراقبة الاداء pod 'Firebase/Performance' FirebasePerformance
قاعدة بيانات الوقت الحقيقي pod 'Firebase/Database' FirebaseDatabase
التكوين عن بعد pod 'Firebase/RemoteConfig' FirebaseRemoteConfig

الدمج بدون مدير التبعية

إذا كنت لا ترغب في استخدام Swift Package Manager ، فلا يزال بإمكانك الاستفادة من Firebase SDKs عن طريق استيراد الإطارات مباشرة أو باستخدام CocoaPods.

إطار أعمال

بالإضافة إلى دعم منصة دائرة الرقابة الداخلية، ويشمل البريدي الآن .xcframework الملفات. لمزيد من التفاصيل، انظر منصات Firebase أبل SDK README على جيثب .

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

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

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

CocoaPods

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

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

تعرف على Firebase:

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