با نظارت بر عملکرد برای فلوتر شروع کنید

این راهنمای سریع، نحوه‌ی راه‌اندازی نظارت بر عملکرد Firebase را شرح می‌دهد تا به شما در درک ویژگی‌های عملکردی برنامه‌های Flutter خود کمک کند.

قبل از اینکه شروع کنی

اگر قبلاً این کار را نکرده‌اید، Firebase را در پروژه Flutter خود پیکربندی و مقداردهی اولیه کنید .

مرحله ۱ : نظارت بر عملکرد را به برنامه خود اضافه کنید

  1. از دایرکتوری ریشه پروژه Flutter خود، دستور زیر را برای نصب افزونه Performance Monitoring Flutter اجرا کنید:

    flutter pub add firebase_performance

  2. از دایرکتوری ریشه پروژه Flutter خود، دستور زیر را اجرا کنید:

    flutterfire configure

    اجرای این دستور تضمین می‌کند که پیکربندی Firebase برنامه Flutter شما به‌روز است و برای اندروید، افزونه Gradle Performance Monitoring مورد نیاز را به برنامه شما اضافه می‌کند.

  3. پس از اتمام، پروژه Flutter خود را از نو بسازید:

    flutter run

پس از افزودن SDK نظارت بر عملکرد، Firebase به طور خودکار شروع به جمع‌آوری داده‌های مربوط به چرخه حیات برنامه شما (مانند زمان شروع برنامه ) و داده‌های مربوط به درخواست‌های شبکه HTTP/S می‌کند.

در فلاتر، نظارت خودکار بر عملکرد رندر صفحه برای صفحات منفرد فلاتر امکان‌پذیر نیست. یک کنترل‌کننده نمای واحد، کل برنامه فلاتر شما را به صورت بومی محصور می‌کند، بنابراین SDK بومی فایربیس از انتقال صفحات آگاه نیست.

مرحله ۲ : ایجاد رویدادهای عملکردی برای نمایش اولیه داده‌ها

فایربیس زمانی که SDK را با موفقیت به برنامه خود اضافه کنید، پردازش رویدادها را آغاز می‌کند. اگر هنوز در حال توسعه محلی هستید، با برنامه خود تعامل داشته باشید تا رویدادهایی را برای جمع‌آوری و پردازش اولیه داده‌ها ایجاد کنید.

  1. با استفاده از یک شبیه‌ساز یا دستگاه آزمایشی، به توسعه برنامه خود ادامه دهید.

  2. با تغییر چندین باره برنامه بین پس‌زمینه و پیش‌زمینه، تعامل با برنامه با پیمایش در صفحه‌های مختلف و/یا ایجاد درخواست‌های شبکه، رویدادها را ایجاد کنید.

  3. به داشبورد Performance کنسول Firebase بروید. باید نمایش اولیه داده‌های خود را ظرف چند دقیقه مشاهده کنید.

    اگر نمایش داده‌های اولیه خود را نمی‌بینید، نکات عیب‌یابی را مرور کنید.

مرحله ۳ : (اختیاری) مشاهده پیام‌های گزارش رویدادهای عملکردی

  1. پیام‌های لاگ خود را برای هرگونه پیام خطا بررسی کنید.

    Performance Monitoring پیام‌های لاگ خود را با برچسب‌های زیر برچسب‌گذاری می‌کند تا بتوانید پیام‌های لاگ خود را فیلتر کنید:

    • iOS+: Firebase/Performance
    • اندروید: FirebasePerformance

  2. انواع گزارش‌های زیر را که نشان می‌دهند Performance Monitoring در حال ثبت رویدادهای عملکردی است، بررسی کنید:

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

  3. برای مشاهده داده‌های خود در کنسول Firebase، روی URL کلیک کنید. ممکن است چند لحظه طول بکشد تا داده‌ها در داشبورد به‌روزرسانی شوند.

مرحله ۴ : (اختیاری) افزودن مانیتورینگ سفارشی برای کد خاص

برای نظارت بر داده‌های عملکرد مرتبط با کد خاص در برنامه خود، می‌توانید ردیابی‌های کد سفارشی را ابزار دقیق کنید.

با یک ردیابی کد سفارشی، می‌توانید مدت زمانی را که برنامه شما برای تکمیل یک کار خاص یا مجموعه‌ای از کارها، مانند بارگذاری مجموعه‌ای از تصاویر یا پرس و جو از پایگاه داده شما، نیاز دارد، اندازه‌گیری کنید. معیار پیش‌فرض برای ردیابی کد سفارشی، مدت زمان آن است، اما می‌توانید معیارهای سفارشی مانند بازدیدهای حافظه پنهان و هشدارهای حافظه را نیز اضافه کنید.

در کد خود، ابتدا و انتهای یک ردیابی کد سفارشی را تعریف می‌کنید (و هر معیار سفارشی دلخواه را اضافه می‌کنید) با استفاده از API ارائه شده توسط Performance Monitoring SDK.

برای کسب اطلاعات بیشتر در مورد این ویژگی‌ها و نحوه افزودن آنها به برنامه خود، به بخش افزودن نظارت برای کد خاص مراجعه کنید.

مرحله ۵ : برنامه خود را مستقر کنید و سپس نتایج را بررسی کنید

پس از اینکه Performance Monitoring را با استفاده از یک شبیه‌ساز و یک یا چند دستگاه آزمایشی تأیید کردید، می‌توانید نسخه به‌روز شده برنامه خود را برای کاربرانتان مستقر کنید.

شما می‌توانید داده‌های عملکرد را در داشبورد Performance کنسول Firebase نظارت کنید.

مراحل بعدی