قبل البدء
إذا لم تكن قد فعلت ذلك بالفعل، إضافة Firebase إلى مشروع Apple
الخطوة 1: إضافة "مراقبة الأداء" إلى تطبيقك
بعد إضافة حزمة SDK لمراقبة الأداء، يبدأ Firebase تلقائيًا في جمع البيانات بيانات عرض الشاشة في تطبيقك، وبيانات المتعلقة بدورة حياة تطبيقك (مثل وقت بدء التطبيق) بيانات طلبات شبكة HTTP/S.
يمكنك استخدام "مدير حزم Swift" لتثبيت اعتماديات Firebase وإدارتها.
- في Xcode، انتقِل إلى File (ملف) > بعد فتح مشروع التطبيق الخاص بك. إضافة حِزم
- أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple عندما يُطلب منك ذلك:
- اختر مكتبة "مراقبة الأداء".
- أضِف العلامة
-ObjC
إلى القسم علامات الروابط الأخرى في إعدادات إصدار هدفك. - عند الانتهاء، سيبدأ Xcode تلقائيًا في حل وتنزيل ملف والتبعيات في الخلفية.
https://github.com/firebase/firebase-ios-sdk.git
بعد ذلك، اضبط وحدة Firebase على النحو التالي:
- استيراد وحدة
FirebaseCore
فيUIApplicationDelegate
بالإضافة إلى أي تطبيق آخر وحدات Firebase التي يستخدمها تطبيقك المفوَّض على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- ضبط
FirebaseApp
المثيل المشترك في حساب مفوَّض تطبيقك طريقةapplication(_:didFinishLaunchingWithOptions:)
:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// 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() } } } }
-
أعِد تجميع تطبيقك.
الخطوة 2: إنشاء أحداث الأداء للعرض الأولي للبيانات
يبدأ Firebase في معالجة الأحداث عند إضافة حزمة تطوير البرامج (SDK) بنجاح إلى التطبيق. إذا كنت لا تزال في مرحلة التطوير محليًا، تفاعَل مع تطبيقك لإنشاء الأحداث لجمع البيانات الأولية ومعالجتها.
واصِل تطوير تطبيقك باستخدام محاكي أو جهاز اختبار.
يمكنك إنشاء أحداث من خلال تبديل تطبيقك بين الخلفية والمقدمة. عدة مرات، والتفاعل مع التطبيق عن طريق التنقل عبر الشاشات، و/أو تشغيل طلبات الشبكة.
انتقِل إلى لوحة بيانات الأداء بوحدة تحكم Firebase. يجب أن تظهر بياناتك الأولية داخل بضع دقائق.
إذا لم يتم عرض بياناتك الأولية، راجع أداة تحري الخلل وإصلاحه النصائح.
الخطوة 3: (اختياري) عرض رسائل السجلّ لأحداث الأداء
فعّل تسجيل تصحيح الأخطاء، كما يلي:
- في Xcode (الإصدار 14.1 كحدٍ أدنى)، اختَر المنتج >. المخطط > تعديل المخطّط:
- حدد تشغيل من القائمة اليمنى، ثم حدد علامة التبويب الوسيطات.
- في قسم الوسيطات التي تم تمريرها عند الإطلاق، أضِف
-FIRDebugEnabled
.
تحقَّق من رسائل السجلّ بحثًا عن أي رسائل خطأ.
تضع "مراقبة الأداء" علامة على رسائل السجلّ باستخدام "
Firebase/Performance
" لكي تصفية رسائل السجل.ابحث عن الأنواع التالية من السجلّات التي تشير إلى أنّ ميزة "مراقبة الأداء" تسجيل أحداث الأداء:
Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
Logging network request trace: URL
انقر على عنوان URL للاطّلاع على بياناتك في "وحدة تحكُّم Firebase". قد يستغرق الأمر بعض أوقات لتعديل البيانات في لوحة البيانات.
إذا لم يكن تطبيقك يسجّل أحداث الأداء، راجِع مقالة تحديد المشاكل وحلّها. النصائح.
الخطوة 4: (اختيارية) إضافة تتبُّع مخصّص لرمز معيّن
لمراقبة بيانات الأداء المرتبطة برمز محدّد في تطبيقك، يمكنك: تتبُّعات الرموز المخصّصة للأداة.
يمكنك من خلال عملية تتبُّع مخصّصة للرموز قياس المدة التي يستغرقها إكمال تطبيقك. مهمة محددة أو مجموعة من المهام، مثل تحميل مجموعة من الصور أو إرسال طلبات بحث قاعدة البيانات لديك. يكون المقياس التلقائي لتتبُّع الرمز المخصّص هو مدته، ولكن يمكنك أيضًا إضافة مقاييس مخصّصة، مثل نتائج ذاكرة التخزين المؤقت وتحذيرات الذاكرة.
في التعليمة البرمجية، يمكنك تحديد بداية ونهاية عملية تتبُّع الرمز المخصّص ( إضافة أي مقاييس مخصّصة مطلوبة) باستخدام واجهة برمجة التطبيقات التي توفرها حزمة تطوير البرامج (SDK) لمراقبة الأداء.
انتقِل إلى مقالة إضافة ميزة تتبُّع رمز محدّد. لمزيد من المعلومات عن هذه الميزات وكيفية إضافتها إلى تطبيقك.
الخطوة 5: نشر تطبيقك ثم مراجعة النتائج
بعد التحقق من مراقبة الأداء باستخدام مُحاكي Xcode وتطبيق واحد أو أكثر أجهزة اختبارية، يمكنك نشر الإصدار المحدّث من التطبيق بين المستخدمين.
يمكنك مراقبة بيانات الأداء في لوحة بيانات الأداء بوحدة تحكم Firebase.
المشكلات المعروفة
- هناك مشاكل توافق معروفة مع أداة "مراقبة الأداء" مع GTMSQLite. ننصح بعدم باستخدام "مراقبة الأداء" مع التطبيقات التي تستخدم GTMSQLite.
- قد تتداخل طريقة التحريك بعد طلب الرقم
FirebaseApp.configure()
مع حزمة SDK لمراقبة الأداء. - تمنع المشكلات المعروفة في محاكي الإصدار 8.0-8.2 من iOS مراقبة الأداء من تسجيل أحداث الأداء. تم إصلاح هذه المشكلات في محاكي iOS 8.3 والإصدارات الأحدث.
- الاتصالات التي تم إنشاؤها باستخدام
backgroundSessionConfiguration
في NSURLSession ستظهر أوقات اتصال أطول من المتوقع. هذه الاتصالات خارج المعالجة وتعكس التوقيتات أحداث الاستدعاء أثناء العملية.
الخطوات التالية
عليك مراجعة وتنفيذ نموذج رمز iOS لمراقبة الأداء على GitHub
في ما يلي مزيد من المعلومات عن البيانات التي يتم جمعها تلقائيًا بواسطة Performance Monitoring:
- البيانات ذات الصلة بدورة حياة تطبيقك، مثل وقت بدء التطبيق
- بيانات عرض الشاشة في تطبيقك
- تم إصدار بيانات طلبات شبكة HTTP/S. من تطبيقك
عرض وتتبّع وفلترة بيانات الأداء في وحدة تحكُّم Firebase.
أضِف مراقبة لمهام أو مهام سير عمل معيّنة في تطبيقك من خلال أدوات تتبُّع الرموز المخصّصة.