Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

أضف 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. في وسط صفحة نظرة عامة على المشروع ، انقر فوق أيقونة iOS ( ) لبدء سير عمل الإعداد.

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

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

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

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

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

  1. انقر فوق تنزيل GoogleService-Info.plist للحصول على ملف تهيئة GoogleService-Info.plist iOS ( GoogleService-Info.plist ).

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

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

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

نوصي باستخدام CocoaPods لتثبيت مكتبات Firebase . ومع ذلك ، إذا كنت تفضل عدم استخدام CocoaPods ، فيمكنك دمج أطر عمل SDK مباشرةً أو استخدام Swift Package Manager (تجريبي) .

هل تستخدم إحدى عينات البدء السريع ؟ ومشروع 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'
    # 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'

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

    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 ، ثم افتح ملف .xcworkspace لترى المشروع في Xcode:

    pod install
    open your-project.xcworkspace

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

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

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

    سويفت

    import Firebase

    ج موضوعية

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

    سويفت

    // 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/AppDistribution'
المصادقة pod 'Firebase/Auth'
سحابة Firestore pod 'Firebase/Firestore'
وظائف السحابة لـ Firebase Client SDK pod 'Firebase/Functions'
المراسلة السحابية pod 'Firebase/Messaging'
سحابة التخزين pod 'Firebase/Storage'
Firebase Crashlytics pod 'Firebase/Crashlytics'
روابط ديناميكية pod 'Firebase/DynamicLinks'
المراسلة داخل التطبيق pod 'Firebase/InAppMessaging'
(مطلوب)
واجهات برمجة التطبيقات للنموذج المخصص لـ 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 iOS SDK README على GitHub .

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

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

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

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

دعم Swift Package Manager حاليًا في مرحلة تجريبية. اتبع الوثائق الموجودة على GitHub ، وقم بتقديم أي ملاحظات إلى متعقب مشكلات GitHub .

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

تعرف على Firebase:

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

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

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

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

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

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

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

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