المتطلبات الأساسية
قم بتثبيت ما يلي:
- Xcode 12.0 أو أحدث
- CocoaPods 1.9.0 أو أحدث
تأكد من أن مشروعك يلبي هذه المتطلبات:
- يجب أن يستهدف مشروعك نظام iOS 10 أو إصدار أحدث.
قم بإعداد جهاز iOS فعليًا أو استخدم محاكي iOS لتشغيل تطبيقك.
بالنسبة إلى Cloud Messaging على iOS ، إليك المتطلبات الأساسية:
- قم بإعداد جهاز iOS فعلي .
- احصل على مفتاح مصادقة Apple Push Notification لحساب Apple Developer الخاص بك.
- قم بتمكين دفع الإشعارات في Xcode ضمن التطبيق> القدرات .
- سجّل الدخول إلى Firebase باستخدام حساب Google الخاص بك.
إذا لم يكن لديك بالفعل مشروع Xcode وتريد فقط تجربة أحد منتجات Firebase ، فيمكنك تنزيل إحدى عينات البدء السريع الخاصة بنا.
الخطوة 1 : أنشئ مشروع Firebase
قبل أن تتمكن من إضافة Firebase إلى تطبيق iOS الخاص بك ، تحتاج إلى إنشاء مشروع Firebase للاتصال بتطبيق iOS الخاص بك. تفضل بزيارة فهم مشاريع Firebase لمعرفة المزيد حول مشاريع Firebase.
الخطوة 2 : تسجيل تطبيقك في Firebase
بعد أن يكون لديك مشروع Firebase ، يمكنك إضافة تطبيق iOS الخاص بك إليه.
تفضل بزيارة فهم مشاريع Firebase لمعرفة المزيد حول أفضل الممارسات والاعتبارات لإضافة تطبيقات إلى مشروع Firebase ، بما في ذلك كيفية التعامل مع متغيرات بناء متعددة.
انتقل إلى وحدة تحكم Firebase .
في وسط صفحة نظرة عامة على المشروع ، انقر فوق أيقونة iOS (
) لبدء سير عمل الإعداد.إذا كنت قد أضفت بالفعل تطبيقًا إلى مشروع Firebase ، فانقر فوق إضافة تطبيق لعرض خيارات النظام الأساسي.
أدخل معرف حزمة التطبيق الخاص بك في حقل معرف حزمة iOS .
يعرّف معرّف الحزمة بشكل فريد تطبيقًا في نظام Apple البيئي.
البحث ID الباقة: فتح نظام التشغيل iOS المشروع في كسكودي، حدد التطبيق المستوى الأعلى في الملاح المشروع، ثم حدد علامة التبويب عام.
قيمة حقل معرف الحزمة هي معرف حزمة iOS (على سبيل المثال ،
com.yourcompany.yourproject
).اعلم أن قيمة معرف الحزمة حساسة لحالة الأحرف ، ولا يمكن تغييرها لتطبيق Firebase iOS هذا بعد تسجيله في مشروع Firebase الخاص بك.
(اختياري) أدخل معلومات التطبيق الأخرى: لقب التطبيق ومعرف متجر التطبيقات .
لقب التطبيق : معرّف داخلي ملائم يظهر لك فقط في وحدة تحكم Firebase
معرف متجر التطبيقات : تستخدمه روابط Firebase الديناميكية لإعادة توجيه المستخدمين إلى صفحة App Store الخاصة بك ومن خلال Google Analytics لاستيراد أحداث التحويل إلى إعلانات Google . إذا لم يكن لتطبيقك معرّف متجر التطبيقات حتى الآن ، يمكنك إضافة المعرّف لاحقًا في إعدادات المشروع .
انقر فوق تسجيل التطبيق .
الخطوة 3 : أضف ملف تكوين Firebase
انقر فوق تنزيل GoogleService-Info.plist للحصول على ملف تهيئة
GoogleService-Info.plist
iOS (GoogleService-Info.plist
).يحتوي ملف تهيئة Firebase على معرّفات فريدة ولكنها غير سرية لمشروعك. لمعرفة المزيد حول ملف التكوين هذا ، تفضل بزيارة فهم مشاريع Firebase .
يمكنك تنزيل ملف تهيئة Firebase مرة أخرى في أي وقت.
تأكد من عدم إلحاق اسم ملف التكوين بأحرف إضافية ، مثل
(2)
.
انقل ملف التكوين الخاص بك إلى جذر مشروع Xcode الخاص بك. إذا طُلب منك ذلك ، فحدد لإضافة ملف التكوين لجميع الأهداف.
إذا كان لديك عدة معرّفات حِزمة في مشروعك ، فيجب عليك إقران معرّف كل حزمة GoogleService-Info.plist
مسجل في وحدة تحكم Firebase بحيث يمكن أن يكون لكل تطبيق ملف GoogleService-Info.plist
الخاص به.
الخطوة 4 : أضف حزم Firebase SDK إلى تطبيقك
نوصي باستخدام CocoaPods لتثبيت مكتبات Firebase . ومع ذلك ، إذا كنت تفضل عدم استخدام CocoaPods ، فيمكنك دمج أطر عمل SDK مباشرة أو استخدام Swift Package Manager (تجريبي) .
هل تستخدم إحدى عينات البدء السريع ؟ ومشروع Xcode وPodfile (مع القرون) موجودة بالفعل، ولكن عليك لا تزال بحاجة إلى إضافة ملف التكوين Firebase بك وتثبيت القرون.
قم بإنشاء ملف Podfile إذا لم يكن لديك بالفعل:
cd your-project-directory
pod init
إلى 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'ثبّت
.xcworkspace
، ثم افتح ملف.xcworkspace
لترى المشروع في Xcode:pod install
open your-project.xcworkspace
الخطوة 5 : تهيئة Firebase في تطبيقك
الخطوة الأخيرة هي إضافة رمز التهيئة إلى التطبيق الخاص بك. ربما تكون قد قمت بذلك بالفعل كجزء من إضافة Firebase إلى تطبيقك. إذا كنت تستخدم مشروع نموذج سريع البدء ، فقد تم القيام بذلك نيابة عنك.
- استيراد وحدة Firebase في
UIApplicationDelegate
:سويفت
import Firebase
ج موضوعية
@import Firebase;
- قم
FirebaseApp
مثيلFirebaseApp
المشترك ، عادةً في تطبيق تطبيقكapplication:didFinishLaunchingWithOptions:
method:سويفت
// Use Firebase library to configure APIs FirebaseApp.configure()
ج موضوعية
// Use Firebase library to configure APIs [FIRApp configure];
- إذا قمت بتضمين Firebase Analytics ، فيمكنك تشغيل تطبيقك لإرسال التحقق إلى وحدة تحكم Firebase بأنك قمت بتثبيت Firebase بنجاح.
هذا هو! يمكنك الانتقال إلى الخطوات التالية .
القرون المتاحة
يسرد هذا القسم منتجات Firebase المدعومة لنظام التشغيل iOS وأقراصها. تعرف على المزيد حول مكتبات Firebase iOS هذه:
Firebase iOS SDK GitHub repo
الخدمة أو المنتج | القرون | إضافة تحليلات؟ |
---|---|---|
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 .
قم بتنزيل إطار SDK zip . هذا ملف ~ 200 ميغا بايت وقد يستغرق بعض الوقت للتنزيل.
قم بفك ضغط الملف ، ثم قم بمراجعة
README
for the Frameworks التي تريد تضمينها في تطبيقك.أضف علامة رابط
ObjC
فيOther Linker Settings
في إعدادات بناء الهدف.
سويفت مدير الحزم
دعم Swift Package Manager حاليًا في مرحلة تجريبية. اتبع الوثائق الموجودة على GitHub ، وقم بتقديم أي ملاحظات إلى متعقب مشكلات GitHub .
الخطوات التالية
تعرف على Firebase:
تفضل بزيارة فهم مشاريع Firebase لمعرفة المزيد حول مشاريع Firebase وأفضل الممارسات للمشاريع.
استكشف نماذج تطبيقات Firebase .
احصل على خبرة عملية مع Firebase iOS Codelab .
استكشف الكود مفتوح المصدر في GitHub .
استعد لإطلاق تطبيقك:
- قم بإعداد تنبيهات الميزانية لمشروعك في Google Cloud Console.
- راقب لوحة معلومات الاستخدام والفوترة في وحدة تحكم Firebase.
- راجع قائمة التحقق من إطلاق Firebase .
أضف خدمات Firebase إلى تطبيقك:
احصل على رؤى حول سلوك المستخدم باستخدام Analytics .
قم بإعداد مصادقة المستخدم مع المصادقة .
تخزين البيانات ، مثل معلومات المستخدم ، باستخدام Cloud Firestore أو Realtime Database .
تخزين الملفات ، مثل الصور ومقاطع الفيديو ، باستخدام Cloud Storage .
تشغيل التعليمات البرمجية الخلفية التي تعمل في بيئة آمنة باستخدام وظائف السحابة .
إرسال الإخطارات مع Cloud Messaging .
اكتشف متى ولماذا يتعطل تطبيقك مع Crashlytics .