شروع به کار با «پایش عملکرد» برای Flutter

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

قبل از شروع

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

مرحله ۱: افزودن «پایش عملکرد» به برنامه

  1. از دایرکتوری ریشه پروژه Flutter، دستور زیر را برای نصب افزونه Flutter «پایش عملکرد» اجرا کنید:

    flutter pub add firebase_performance

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

    flutterfire configure

    اجرای این فرمان تضمین می‌کند که پیکربندی Firebase برنامه Flutter شما به‌روز است و، برای Android، افزونه Gradle لازم برای «پایش عملکرد» را به برنامه‌تان اضافه می‌کند.

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

    flutter run

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

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

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

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

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

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

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

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

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

  1. پیام‌های گزارش را برای یافتن پیام‌های خطا بررسی کنید.

    «پایش عملکرد» پیام‌های گزارش خود را با برچسب‌های زیر برچسب‌گذاری می‌کند تا بتوانید پیام‌های گزارش خود را فیلتر کنید:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. انواع گزارش‌های زیر را که نشان می‌دهد «پایش عملکرد» رویدادهای عملکرد را ثبت می‌کند بررسی کنید:

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

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

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

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

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

در کدتان، ابتدا و انتهای ردگیری کد سفارشی را تعریف می‌کنید (و هر سنجه سفارشی دلخواهی را اضافه می‌کنید) بااستفاده از میانای برنامه‌سازی کاربردی ارائه‌شده توسط کیت توسعه نرم‌افزار «پایش عملکرد».

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

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

پس‌از اینکه «پایش عملکرد» را بااستفاده از شبیه‌ساز و یک یا چند دستگاه آزمایشی اعتبارسنجی کردید، می‌توانید نسخه به‌روزشده برنامه‌تان را برای کاربران مستقر کنید.

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

مراحل بعدی