تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

قم بتثبيت ما يلي:
- Xcode 13.3.1 أو أحدث
تأكد من أن مشروعك يلبي هذه المتطلبات:
- يجب أن يستهدف مشروعك إصدارات النظام الأساسي هذه أو أحدث:
  - iOS 11
  - macOS 10.13
  - tvOS 12
  - watchOS 6

قم بإعداد جهاز Apple فعليًا أو استخدم جهاز محاكاة لتشغيل تطبيقك.
هل تريد استخدام المراسلة السحابية؟
بالنسبة إلى Cloud Messaging على أنظمة Apple الأساسية ، إليك المتطلبات الأساسية:
- قم بإعداد جهاز Apple فعلي .
- احصل على مفتاح مصادقة Apple Push Notification لحساب Apple Developer الخاص بك.
- قم بتمكين دفع الإخطارات في Xcode ضمن التطبيق> القدرات .

سجّل الدخول إلى Firebase باستخدام حساب Google الخاص بك.

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

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

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

أنشئ مشروع Firebase

في وحدة تحكم Firebase ، انقر على إضافة مشروع .
- لإضافة موارد Firebase إلى مشروع Google Cloud موجود ، أدخل اسم المشروع أو حدده من القائمة المنسدلة.
- لإنشاء مشروع جديد ، أدخل اسم المشروع المطلوب. يمكنك أيضًا تعديل معرّف المشروع المعروض أسفل اسم المشروع اختياريًا.
  يُنشئ Firebase معرّفًا فريدًا لمشروع Firebase بناءً على الاسم الذي تطلقه عليه. إذا كنت تريد تعديل معرّف المشروع هذا ، فيجب عليك القيام بذلك الآن لأنه لا يمكن تغييره بعد توفير Firebase للموارد لمشروعك. تفضل بزيارة فهم مشاريع Firebase للتعرف على كيفية استخدام Firebase لمعرف المشروع.
راجع شروط Firebase واقبلها ، إذا طُلب منك ذلك.
انقر فوق متابعة .
(اختياري) قم بإعداد Google Analytics لمشروعك ، مما يتيح لك الحصول على تجربة مثالية باستخدام أي من منتجات Firebase التالية:
Firebase Crashlytics
Firebase Cloud Messaging
المراسلة داخل تطبيق Firebase
تهيئة Firebase عن بُعد
التخصيص عن بعد
اختبار Firebase A / B
حدد إما حساب Google Analytics موجود أو لإنشاء حساب جديد.
إذا أنشأت حسابًا جديدًا ، فحدد موقع تقارير Analytics ، ثم اقبل إعدادات مشاركة البيانات وشروط Google Analytics لمشروعك.
يمكنك دائمًا إعداد Google Analytics لاحقًا في علامة التبويب " التكامل " في المشروع الخاصة بك.
انقر على إنشاء مشروع (أو إضافة Firebase ، إذا كنت تستخدم مشروع Google Cloud موجودًا).

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

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

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

انتقل إلى وحدة تحكم Firebase .
في وسط صفحة نظرة عامة على المشروع ، انقر فوق أيقونة + iOS لبدء سير عمل الإعداد.
إذا كنت قد أضفت بالفعل تطبيقًا إلى مشروع Firebase ، فانقر فوق إضافة تطبيق لعرض خيارات النظام الأساسي.
أدخل معرف حزمة التطبيق الخاص بك في حقل معرف الحزمة .
ما هو معرف الحزمة وأين تجده؟
- يحدد معرف الحزمة بشكل فريد تطبيقًا في نظام Apple البيئي.
- ابحث عن معرف الحزمة الخاص بك: افتح مشروعك في Xcode ، وحدد التطبيق ذي المستوى الأعلى في متصفح المشروع ، ثم حدد علامة التبويب " عام ".
  قيمة حقل معرف الحزمة هي معرف الحزمة (على سبيل المثال ، com.yourcompany.yourproject ).
- اعلم أن قيمة معرّف الحزمة حساسة لحالة الأحرف ، ولا يمكن تغييرها لتطبيق Firebase هذا بعد تسجيله في مشروع Firebase.
تأكد من إدخال معرف الحزمة الذي يستخدمه تطبيقك بالفعل. قيمة معرّف الحزمة حساسة لحالة الأحرف ، ولا يمكن تغييرها لتطبيق Firebase Apple هذا بعد تسجيله في مشروع Firebase.
(اختياري) أدخل معلومات التطبيق الأخرى: لقب التطبيق ومعرف متجر التطبيقات .
كيف يتم استخدام لقب التطبيق ومعرف متجر التطبيقات داخل Firebase؟
- لقب التطبيق : معرّف داخلي ملائم يكون مرئيًا لك فقط في وحدة تحكم Firebase
- معرف متجر التطبيقات : تستخدمه روابط Firebase الديناميكية لإعادة توجيه المستخدمين إلى صفحة App Store الخاصة بك ومن خلال Google Analytics لاستيراد أحداث التحويل إلى إعلانات Google . إذا لم يكن لتطبيقك معرّف متجر التطبيقات حتى الآن ، يمكنك إضافة المعرّف لاحقًا في إعدادات المشروع .
انقر فوق تسجيل التطبيق .

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

انقر فوق تنزيل GoogleService-Info.plist للحصول على ملف تهيئة أنظمة تشغيل Firebase Apple ( GoogleService-Info.plist ).
ماذا تريد أن تعرف عن ملف التكوين هذا؟
- يحتوي ملف تهيئة Firebase على معرّفات فريدة ولكنها غير سرية لمشروعك. لمعرفة المزيد حول ملف التكوين هذا ، تفضل بزيارة فهم مشاريع Firebase .
- يمكنك تنزيل ملف تهيئة Firebase مرة أخرى في أي وقت.
- تأكد من عدم إلحاق اسم ملف التكوين بأحرف إضافية ، مثل (2) .
انقل ملف التكوين الخاص بك إلى جذر مشروع Xcode الخاص بك. إذا طُلب منك ذلك ، فحدد لإضافة ملف التكوين إلى جميع الأهداف.

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

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

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

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

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

حدد إصدار SDK الذي تريد استخدامه.
ملاحظة: نوصي باستخدام إصدار SDK الافتراضي (الأحدث) ، ولكن يمكنك اختيار إصدار أقدم إذا لزم الأمر.
اختر مكتبات Firebase التي تريد استخدامها.
إذا تم تمكين Google Analytics في مشروع Firebase ، فتأكد من إضافة FirebaseAnalytics . بالنسبة إلى Analytics بدون إمكانية جمع IDFA ، أضف FirebaseAnalyticsWithoutAdId بدلاً من ذلك.

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

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

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

قم باستيراد وحدة FirebaseCore في مندوب UIApplicationDelegate ، بالإضافة إلى أي وحدات Firebase أخرى يستخدمها مفوض التطبيق. على سبيل المثال ، لاستخدام Cloud Firestore والمصادقة:
SwiftUI
```
import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
سويفت
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
ج موضوعية
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```

قم بتهيئة مثيل FirebaseApp مشترك في تطبيق مفوض application(_:didFinishLaunchingWithOptions:) :

SwiftUI

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

سويفت

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

ج موضوعية

// Use Firebase library to configure APIs
[FIRApp configure];

إذا كنت تستخدم SwiftUI ، فيجب عليك إنشاء مفوض للتطبيق وإرفاقه بهيكل App الخاص بك عبر UIApplicationDelegateAdaptor أو NSApplicationDelegateAdaptor . يجب عليك أيضًا تعطيل استخدام مفوض التطبيق. لمزيد من المعلومات ، راجع تعليمات SwiftUI .
SwiftUI
```
@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
      
```
إذا قمت بتضمين Firebase SDK لـ Google Analytics ، فيمكنك تشغيل تطبيقك لإرسال التحقق إلى وحدة تحكم Firebase بأنك قمت بتثبيت Firebase بنجاح.

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

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

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

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

الوثائق المرجعية ( Swift | Obj-C )
منصات Firebase Apple SDK GitHub repo

الخدمة أو المنتج	القرون	مكتبات 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`
Crashlytics	`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

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

CocoaPods

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

إطار أعمال

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

قم بتنزيل إطار SDK zip . هذا ملف ~ 200 ميغا بايت وقد يستغرق بعض الوقت للتنزيل.
قم بفك ضغط الملف ، ثم قم بمراجعة README للأطر التي تريد تضمينها في تطبيقك.
أضف علامة رابط -ObjC في Other Linker Settings في إعدادات بناء الهدف.

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

تعرف على Firebase:

تفضل بزيارة فهم مشاريع Firebase لمعرفة المزيد حول مشاريع Firebase وأفضل الممارسات للمشاريع.
استكشاف نماذج تطبيقات Firebase .
احصل على خبرة عملية مع Firebase iOS Codelab .
استكشف الكود مفتوح المصدر في GitHub .
استعد لإطلاق تطبيقك:
- قم بإعداد تنبيهات الميزانية لمشروعك في Google Cloud Console.
- راقب لوحة معلومات الاستخدام والفوترة في وحدة تحكم Firebase للحصول على صورة شاملة لاستخدام مشروعك عبر خدمات Firebase المتعددة.
- راجع قائمة التحقق الخاصة بإطلاق Firebase .
هل تواجه مشكلة في Firebase ومشروع Apple الخاص بك؟ قم بزيارة استكشاف أخطاء منصات Apple والأسئلة الشائعة .

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

احصل على رؤى حول سلوك المستخدم باستخدام Analytics .
قم بإعداد مصادقة المستخدم مع المصادقة .
قم بتخزين البيانات ، مثل معلومات المستخدم ، باستخدام Cloud Firestore أو Realtime Database .
قم بتخزين الملفات ، مثل الصور ومقاطع الفيديو ، باستخدام Cloud Storage .
تشغيل رمز الواجهة الخلفية الذي يعمل في بيئة آمنة باستخدام وظائف السحابة .
إرسال الإخطارات مع Cloud Messaging .
اكتشف متى ولماذا يتعطل تطبيقك مع Crashlytics .