Catch up on highlights from Firebase at Google I/O 2023. Learn more

ابدأ بمراقبة الأداء لمنصات Apple

قبل ان تبدأ

أضف Firebase إلى مشروع Apple الخاص بك ، إذا لم تكن قد قمت بذلك بالفعل.

الخطوة 1 : أضف مراقبة الأداء إلى تطبيقك

بعد إضافة SDK لمراقبة الأداء ، يبدأ Firebase تلقائيًا في جمع البيانات لعرض شاشة تطبيقك ، والبيانات المتعلقة بدورة حياة تطبيقك (مثل وقت بدء التطبيق ) ، وبيانات طلبات شبكة HTTP / S.

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

  1. في Xcode ، مع فتح مشروع التطبيق الخاص بك ، انتقل إلى ملف> إضافة حزم .
  2. عند المطالبة ، أضف مستودع SDK لأنظمة Apple الأساسية لـ Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. اختر مكتبة مراقبة الأداء.
  4. عند الانتهاء ، سيبدأ Xcode تلقائيًا في حل وتنزيل التبعيات الخاصة بك في الخلفية.

بعد ذلك ، هيئ وحدة Firebase:

  1. قم باستيراد وحدة 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;
// ...
  2. قم بتهيئة مثيل 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];
  3. إذا كنت تستخدم 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()
      }
    }
  }
}

  4. أعد تجميع تطبيقك.

الخطوة 2 : إنشاء أحداث الأداء لعرض البيانات الأولية

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

  1. استمر في تطوير تطبيقك باستخدام جهاز محاكاة أو جهاز اختبار.

  2. أنشئ الأحداث من خلال تبديل التطبيق الخاص بك بين الخلفية والمقدمة عدة مرات ، والتفاعل مع تطبيقك من خلال التنقل عبر الشاشات ، و / أو تشغيل طلبات الشبكة.

  3. انتقل إلى لوحة معلومات الأداء لوحدة تحكم Firebase. يجب أن تشاهد عرض بياناتك الأولية في غضون بضع دقائق.

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

الخطوة 3 : (اختياري) اعرض رسائل السجل لأحداث الأداء

  1. تفعيل تسجيل التصحيح ، كما يلي:

    1. في Xcode (الإصدار 14.1 كحد أدنى) ، حدد المنتج > المخطط > تحرير المخطط .
    2. حدد تشغيل من القائمة اليسرى ، ثم حدد علامة التبويب وسائط .
    3. في قسم Arguments Passed on Launch ، أضف -FIRDebugEnabled .

  2. تحقق من رسائل السجل الخاصة بك بحثًا عن أي رسائل خطأ.

  3. تعمل مراقبة الأداء على تمييز رسائل السجل الخاصة بها باستخدام Firebase/Performance بحيث يمكنك تصفية رسائل السجل الخاصة بك.

  4. تحقق من الأنواع التالية من السجلات التي تشير إلى أن مراقبة الأداء تسجل أحداث الأداء:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  5. انقر فوق عنوان URL لعرض بياناتك في وحدة تحكم Firebase. قد يستغرق تحديث البيانات في لوحة المعلومات بضع لحظات.

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

الخطوة 4 : (اختياري) أضف مراقبة مخصصة لرمز معين

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

باستخدام تتبع رمز مخصص ، يمكنك قياس الوقت الذي يستغرقه تطبيقك لإكمال مهمة معينة أو مجموعة من المهام ، مثل تحميل مجموعة من الصور أو الاستعلام عن قاعدة البيانات الخاصة بك. المقياس الافتراضي لتتبع التعليمات البرمجية المخصصة هو مدته ، ولكن يمكنك أيضًا إضافة مقاييس مخصصة ، مثل نتائج ذاكرة التخزين المؤقت وتحذيرات الذاكرة.

في التعليمات البرمجية الخاصة بك ، تقوم بتحديد بداية ونهاية تتبع رمز مخصص (وإضافة أي مقاييس مخصصة مطلوبة) باستخدام واجهة برمجة التطبيقات التي توفرها SDK لمراقبة الأداء.

قم بزيارة إضافة مراقبة لرمز معين لمعرفة المزيد حول هذه الميزات وكيفية إضافتها إلى تطبيقك.

الخطوة 5 : نشر التطبيق الخاص بك ثم مراجعة النتائج

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

يمكنك مراقبة بيانات الأداء في لوحة معلومات الأداء لوحدة تحكم Firebase.

مشاكل معروفة

  • مراقبة الأداء لها مشكلات توافق معروفة مع GTMSQLite. نوصي بعدم استخدام مراقبة الأداء مع التطبيقات التي تستخدم GTMSQLite.
  • قد يتداخل أسلوب التبديل السريع بعد استدعاء FirebaseApp.configure() مع SDK لمراقبة الأداء.
  • تمنع المشكلات المعروفة في iOS 8.0-8.2 Simulator مراقبة الأداء من التقاط أحداث الأداء. تم إصلاح هذه المشكلات في iOS 8.3 Simulator والإصدارات الأحدث.
  • الاتصالات التي تم إنشاؤها باستخدام backgroundSessionConfiguration لـ NSURLSession ستعرض أوقات اتصال أطول من المتوقع. يتم تنفيذ هذه الاتصالات خارج المعالجة وتعكس التوقيتات أحداث رد الاتصال قيد المعالجة.

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