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

قبل ان تبدأ

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

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

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

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

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

بعد ذلك، قم بتكوين وحدة Firebase:

  1. قم باستيراد وحدة FirebaseCore في UIApplicationDelegate ، بالإضافة إلى أي وحدات Firebase أخرى يستخدمها مندوب تطبيقك. على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:

    سويفتويي

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    سويفت

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    ج موضوعية

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. قم بتكوين مثيل FirebaseApp مشترك في طريقة application(_:didFinishLaunchingWithOptions:) :

    سويفتويي

    // 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 . يجب عليك أيضًا تعطيل swizzling مندوب التطبيق. لمزيد من المعلومات، راجع تعليمات 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. في قسم الوسائط التي تم تمريرها عند التشغيل ، أضف -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 ستعرض وقتًا أطول من أوقات الاتصال المتوقعة. يتم تنفيذ هذه الاتصالات خارج العملية وتعكس التوقيتات أحداث رد الاتصال قيد التشغيل.

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