Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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

    • يجب أن يستهدف مشروعك نظام التشغيل iOS 10 أو إصدار أحدث.
  • قم بإعداد جهاز iOS فعليًا أو استخدم محاكي iOS لتشغيل تطبيقك.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

نوصي باستخدام CocoaPods لتثبيت المكتبات Firebase. ومع ذلك، إذا كنت تفضل عدم استخدام CocoaPods، يمكنك دمج الأطر SDK مباشرة أو استخدام سويفت مدير الحزم بدلا من ذلك.

هل تستخدم واحدة من عينات التشغيل السريع ؟ ومشروع Xcode وPodfile (مع القرون) موجودة بالفعل، ولكن عليك لا تزال بحاجة إلى إضافة ملف التكوين Firebase بك وتثبيت القرون.

  1. قم بإنشاء ملف Podfile إذا لم يكن لديك واحد بالفعل:

    cd your-project-directory
    pod init
  2. إلى Podfile الخاص بك ، أضف بودات Firebase التي تريد استخدامها في تطبيقك.

    يمكنك إضافة أي من المنتجات Firebase دعم لتطبيقات نظام التشغيل iOS الخاص بك.

    تم تمكين التحليلات

    platform :ios, ‘10.0’
    # Add the Firebase pod for Google Analytics pod 'Firebase/Analytics' # For Analytics without IDFA collection capability, use this pod instead # pod ‘Firebase/AnalyticsWithoutAdIdSupport’ # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'

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

    لم يتم تمكين التحليلات

    platform :ios, ‘10.0’
    # Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'
  3. تثبيت القرون، ثم فتح الخاص بك .xcworkspace ملف لرؤية المشروع في كسكودي:

    pod install
    open your-project.xcworkspace

خطوة 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 Analytics ، فيمكنك تشغيل تطبيقك لإرسال التحقق إلى وحدة تحكم Firebase بأنك قمت بتثبيت Firebase بنجاح.

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

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

القرون المتاحة

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

الخدمة أو المنتج القرون إضافة تحليلات؟
AdMob pod 'Google-Mobile-Ads-SDK'
تحليلات pod 'Firebase/Analytics'
التحقق من التطبيق pod 'Firebase/AppCheck'
توزيع التطبيق pod 'Firebase/AppDistribution'
المصادقة pod 'Firebase/Auth'
سحابة Firestore pod 'Firebase/Firestore'
وظائف السحابة لـ Firebase Client SDK pod 'Firebase/Functions'
المراسلة السحابية pod 'Firebase/Messaging'
سحابة التخزين pod 'Firebase/Storage'
Crashlytics pod 'Firebase/Crashlytics'
روابط ديناميكية pod 'Firebase/DynamicLinks'
المراسلة داخل التطبيق pod 'Firebase/InAppMessaging'
(مطلوب)
منشآت Firebase pod 'Firebase/Installations'
واجهات برمجة التطبيقات للنموذج المخصص لـ Firebase ML pod 'Firebase/MLModelDownloader'
مراقبة الاداء pod 'Firebase/Performance'
قاعدة بيانات الوقت الفعلي pod 'Firebase/Database'
التكوين عن بعد pod 'Firebase/RemoteConfig'

الدمج بدون CocoaPods

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

إطار أعمال

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

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

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

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

سويفت مدير الحزم

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

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

تعرف على Firebase:

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