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

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

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

  • Xcode 12.5 أو أحدث

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

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

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

  هل تريد استخدام المراسلة السحابية؟

  بالنسبة إلى Cloud Messaging على أنظمة Apple الأساسية ، إليك المتطلبات الأساسية:

  • إعداد جهاز أبل البدني.
  • الحصول على أبل دفع الإخطار مصادقة المفاتيح الخاصة بك أبل حساب المطور .
  • تمكين إخطارات دفع في كسكودي تحت التطبيقات> قدرات.

• تسجيل الدخول إلى Firebase باستخدام حسابك في Google.

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

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

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

أنشئ مشروع Firebase

1. في وحدة التحكم Firebase ، انقر فوق المشروع إضافة.

   • لإضافة موارد Firebase إلى مشروع جوجل الغيمة القائمة، أدخل اسم المشروع، أو تحديده من القائمة المنسدلة.

   • لإنشاء مشروع جديد ، أدخل اسم المشروع المطلوب. يمكنك أيضًا تعديل معرّف المشروع المعروض أسفل اسم المشروع اختياريًا.

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

2. إذا طلب منك مراجعة وقبول الشروط Firebase .

3. انقر فوق متابعة.

4. (اختياري) تعيين ما يصل Google Analytics للمشروع، والتي تمكنك من الحصول على تجربة مثالية باستخدام أي من المنتجات Firebase التالية:

   Firebase Crashlytics توقعات Firebase

   Firebase Cloud Messaging المراسلة داخل تطبيق Firebase

   تهيئة Firebase عن بُعد اختبار Firebase A / B

   إما تحديد القائمة حساب Google Analytics أو إنشاء حساب جديد.

   إذا قمت بإنشاء حساب جديد، حدد الخاص بك تحليلات الإبلاغ عن الموقع ، ثم قبول الإعدادات تبادل البيانات والشروط Google Analytics للمشروع الخاص بك.

   يمكنك دائما إعداد برنامج Google Analytics في وقت لاحق في التكاملات التبويب الخاص بك إعدادات المشروع.

5. إضغط على انشاء مشروع (أو اضافة Firebase، إذا كنت تستخدم مشروع جوجل الغيمة الحالية).

يوفر Firebase الموارد تلقائيًا لمشروع Firebase. عند اكتمال العملية ، سيتم نقلك إلى صفحة النظرة العامة لمشروع Firebase في وحدة تحكم Firebase.

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

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

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

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

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

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

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

   ما هو معرف الحزمة وأين تجده؟

   • A رمز الرزمة بشكل فريد تطبيق في النظام البيئي لشركة أبل.

   • البحث ID الباقة: فتح مشروعك في كسكودي، حدد التطبيق المستوى الأعلى في الملاح المشروع، ثم حدد علامة التبويب عام.

     قيمة الحقل حزمة معرف هي رمز الرزمة (على سبيل المثال، com.yourcompany.yourproject ).

   • اعلم أن قيمة معرّف الحزمة حساسة لحالة الأحرف ، ولا يمكن تغييرها لتطبيق Firebase هذا بعد تسجيله في مشروع Firebase.

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

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

   كيف هي كنية التطبيقات والتطبيقات مخزن رقم المستخدمة في Firebase؟

   • التطبيق اللقب: داخلي، معرف الراحة التي مرئيا لك فقط في وحدة تحكم Firebase

   • المتجر ID: المستخدمة من قبل Firebase الحيوي روابط ل إعادة توجيه المستخدمين إلى صفحة المتجر الخاص بك ومن قبل Google Analytics ل أحداث تحويل الواردات إلى إعلانات جوجل . إذا لم التطبيق لديها حتى الآن على المتجر ID، يمكنك إضافة ID في وقت لاحق بك إعدادات المشروع .

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

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

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

   ماذا تريد أن تعرف عن ملف التكوين هذا؟

   • يحتوي ملف تهيئة Firebase على معرّفات فريدة ولكنها غير سرية لمشروعك. لمعرفة المزيد حول هذا الملف التكوين، قم بزيارة فهم مشاريع Firebase .

   • يمكنك تحميل الخاص بك ملف التكوين Firebase مرة أخرى في أي وقت.

   • تأكد من عدم إلحاق اسم ملف التكوين مع أحرف إضافية، مثل (2) .

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

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

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

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

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

1. في كسكودي، مع مشروع التطبيق فتح، انتقل إلى ملف> حزم سويفت> إضافة حزمة التبعية.
2. عند المطالبة ، قم بإضافة مستودع SDK لأنظمة Firebase Apple الأساسية:

  https://github.com/firebase/firebase-ios-sdk
  

3. حدد إصدار SDK الذي تريد استخدامه.
   ملاحظة: نوصي باستخدام الإصدار SDK الافتراضي (آخر)، ولكن يمكنك اختيار نسخة قديمة إذا لزم الأمر.

4. اختر مكتبات 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 الأساسي:

• الوثائق المرجعية ( سويفت | الكائنات C )

• منصات Firebase أبل SDK جيثب الريبو

المكتبة Firebase الأساسية ( Firebase/Core لم تعد هناك حاجة). تضمنت SDK حزمة Firebase SDK لبرنامج Google Analytics.

الآن ، لاستخدام Analytics أو أي من منتجات Firebase التي توصي باستخدام Analytics (انظر الجدول أدناه) ، تحتاج إلى تضمين Firebase SDK بشكل صريح لبرنامج Google Analytics.

الخدمة أو المنتج	القرون	مكتبات 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 لمعرفة المزيد عن مشاريع Firebase وأفضل الممارسات للمشاريع.

• استكشاف التطبيقات Firebase عينة .

• الحصول على خبرة مع Firebase دائرة الرقابة الداخلية Codelab .

• استكشاف فتح شفرة المصدر في جيثب .

• استعد لإطلاق تطبيقك:

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

• هل تواجه مشكلة في Firebase ومشروع Apple الخاص بك؟ زيارة منصات أبل استكشاف الأخطاء وإصلاحها والتعليمات .

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

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

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

• تخزين البيانات، مثل معلومات المستخدم، مع سحابة Firestore أو قاعدة البيانات في الوقت الحقيقي .

• تخزين الملفات، مثل الصور والفيديو، مع سحابة التخزين .

• كود الزناد الخلفية التي يتم تشغيلها في بيئة آمنة مع وظائف الغيمة .

• إرسال الإخطارات مع سحابة التراسل .

• معرفة متى ولماذا التطبيق الخاص بك هو تحطمها مع Crashlytics .