Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

ابدأ مع مراقبة الأداء لنظام iOS

قبل ان تبدأ

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

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

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

  1. افتح ملف podfile الذي أنشأته للمشروع (أو قم بتشغيل pod init لإنشاء واحد) ، ثم أضف السطر التالي داخل القسم الهدف:

    pod 'Firebase/Performance'
  2. في دليل ملف podfile الخاص بك ، قم بتشغيل الأمر التالي لتثبيت SDK لمراقبة الأداء:

    pod install
  3. افتح ملف .xcworkspace باستخدام Xcode.

  4. استيراد وحدة Firebase في UIApplicationDelegate :

    سويفت

    import Firebase

    ج موضوعية

    @import Firebase;
  5. قم FirebaseApp مثيل FirebaseApp المشترك ، عادةً في تطبيق تطبيقك application:didFinishLaunchingWithOptions: method:

    سويفت

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

    ج موضوعية

    // Use Firebase library to configure APIs
    [FIRApp configure];
  6. أعد تجميع تطبيقك.

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

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

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

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

  3. انتقل إلى لوحة معلومات الأداء لوحدة تحكم Firebase لمعرفة ما إذا كان Firebase قد اكتشف SDK.

    إذا لم تظهر لك رسالة "تم اكتشاف SDK" ، فراجع نصائح استكشاف الأخطاء وإصلاحها .

  4. تعالج مراقبة الأداء بيانات حدث الأداء قبل عرضها في لوحة معلومات الأداء . من المفترض أن يتم عرض بياناتك الأولية في غضون 24 ساعة من رؤية رسالة اكتشاف SDK.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مشاكل معروفة

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

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