قبل از شروع
اگر قبلاً این کار را نکردهاید، Firebase را به پروژه Android خود اضافه کنید .
مرحله 1 : SDK Performance Monitoring را به برنامه خود اضافه کنید
پس از اینکه SDK Performance Monitoring را اضافه کردید، Firebase به طور خودکار شروع به جمعآوری دادهها برای رندر صفحه برنامه و دادههای مربوط به چرخه عمر برنامه شما میکند (مانند زمان شروع برنامه ). برای فعال کردن Firebase برای نظارت بر درخواستهای شبکه، باید افزونه Performance Monitoring Gradle را نیز اضافه کنید (مرحله بعد).
در فایل Gradle ماژول (سطح برنامه) خود (معمولا
<project>/<app-module>/build.gradle.kts
یا<project>/<app-module>/build.gradle
)، وابستگی را برای Performance Monitoring اضافه کنید. کتابخانه برای اندروید توصیه میکنیم از Firebase Android BoM برای کنترل نسخهسازی کتابخانه استفاده کنید.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.3.0")) // Add the dependency for the Performance Monitoring library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-perf") }
با استفاده از Firebase Android BoM ، برنامه شما همیشه از نسخههای سازگار کتابخانههای Firebase Android استفاده میکند.
به دنبال یک ماژول کتابخانه خاص کاتلین هستید؟ از اکتبر 2023 ( Firebase BoM 32.5.0) ، توسعه دهندگان Kotlin و Java می توانند به ماژول کتابخانه اصلی وابسته باشند (برای جزئیات، به سؤالات متداول در مورد این ابتکار مراجعه کنید).(جایگزین) وابستگی های کتابخانه Firebase را بدون استفاده از BoM اضافه کنید
اگر تصمیم گرفتید از Firebase BoM استفاده نکنید، باید هر نسخه کتابخانه Firebase را در خط وابستگی آن مشخص کنید.
توجه داشته باشید که اگر از چندین کتابخانه Firebase در برنامه خود استفاده می کنید، ما قویاً توصیه می کنیم از BoM برای مدیریت نسخه های کتابخانه استفاده کنید، که تضمین می کند همه نسخه ها سازگار هستند.
dependencies { // Add the dependency for the Performance Monitoring library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-perf:21.0.1") }
برنامه خود را دوباره کامپایل کنید
مرحله 2 : افزونه Performance Monitoring Gradle را به برنامه خود اضافه کنید
پس از افزودن افزونه Performance Monitoring Gradle، Firebase به طور خودکار شروع به جمعآوری دادهها برای درخواستهای شبکه HTTP/S میکند. این افزونه همچنین به شما امکان میدهد تا با استفاده از حاشیهنویسی @AddTrace، ردیابی کد سفارشی را تنظیم کنید.
در فایل Gradle سطح ریشه (سطح پروژه) خود (
<project>/build.gradle.kts
یا<project>/build.gradle
)، افزونه Gradle Performance Monitoring اضافه کنید:Kotlin
plugins { // To benefit from the latest Performance Monitoring plugin features, // update your Android Gradle plugin dependency to at least v3.4.0 id("com.android.application") version "7.3.0" apply false // Make sure that you have the Google services Gradle plugin dependency id("com.google.gms.google-services") version "4.4.2" apply false // Add the dependency for the Performance Monitoring Gradle plugin id("com.google.firebase.firebase-perf") version "1.4.2" apply false }
Groovy
plugins { // To benefit from the latest Performance Monitoring plugin features, // update your Android Gradle plugin dependency to at least v3.4.0 id 'com.android.application' version '7.3.0' apply false // Make sure that you have the Google services Gradle plugin dependency id 'com.google.gms.google-services' version '4.4.2' apply false // Add the dependency for the Performance Monitoring Gradle plugin id 'com.google.firebase.firebase-perf' version '1.4.2' apply false }
در فایل Gradle ماژول (سطح برنامه) خود (معمولا
<project>/<app-module>/build.gradle.kts
یا<project>/<app-module>/build.gradle
)، افزونه Performance Monitoring Gradle را اضافه کنید:Kotlin
plugins { id("com.android.application") // Make sure that you have the Google services Gradle plugin id("com.google.gms.google-services") // Add the Performance Monitoring Gradle plugin id("com.google.firebase.firebase-perf") ... }
Groovy
plugins { id 'com.android.application' // Make sure that you have the Google services Gradle plugin id 'com.google.gms.google-services' // Add the Performance Monitoring Gradle plugin id 'com.google.firebase.firebase-perf' ... }
برنامه خود را دوباره کامپایل کنید
مرحله 3 : رویدادهای عملکرد را برای نمایش داده های اولیه ایجاد کنید
هنگامی که SDK را با موفقیت به برنامه خود اضافه کنید، Firebase پردازش رویدادها را شروع می کند. اگر هنوز به صورت محلی در حال توسعه هستید، با برنامه خود تعامل داشته باشید تا رویدادهایی برای جمع آوری و پردازش داده های اولیه ایجاد کنید.
رویدادها را با جابجایی برنامه خود بین پسزمینه و پیشزمینه چندین بار، تعامل با برنامه خود با پیمایش در صفحهها و/یا راهاندازی درخواستهای شبکه ایجاد کنید.
به داشبورد Performance کنسول Firebase بروید. در عرض چند دقیقه باید نمایش داده های اولیه خود را ببینید.
اگر نمایش دادههای اولیه خود را نمیبینید، نکات عیبیابی را مرور کنید.
مرحله 4 : (اختیاری) پیامهای گزارش رویدادهای عملکرد را مشاهده کنید
با افزودن یک عنصر
<meta-data>
به فایلAndroidManifest.xml
برنامه خود، گزارش اشکال زدایی را برای Performance Monitoring در زمان ساخت فعال کنید، مانند:<application> <meta-data android:name="firebase_performance_logcat_enabled" android:value="true" /> </application>
پیام های گزارش خود را برای هرگونه پیام خطا بررسی کنید.
Performance Monitoring پیامهای گزارش خود را با
FirebasePerformance
برچسبگذاری میکند. با استفاده از فیلتر logcat، می توانید به طور خاص با اجرای دستور زیر، ردیابی مدت زمان و ثبت درخواست شبکه HTTP/S را مشاهده کنید:adb logcat -s FirebasePerformance
انواع گزارشهای زیر را بررسی کنید که نشان میدهد Performance Monitoring ، رویدادهای عملکرد را ثبت میکند:
-
Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
-
Logging network request trace: URL
-
برای مشاهده داده های خود در کنسول Firebase روی URL کلیک کنید. ممکن است چند لحظه طول بکشد تا داده ها در داشبورد به روز شوند.
اگر برنامه شما رویدادهای عملکرد را ثبت نمیکند، نکات عیبیابی را مرور کنید.
مرحله 5 : (اختیاری) نظارت سفارشی را برای کد خاص اضافه کنید
برای نظارت بر داده های عملکرد مرتبط با کد خاص در برنامه خود، می توانید ردیابی کد سفارشی را ابزار کنید.
با ردیابی کد سفارشی، می توانید اندازه گیری کنید که برنامه شما چقدر طول می کشد تا یک کار خاص یا مجموعه ای از وظایف را انجام دهد، مانند بارگیری مجموعه ای از تصاویر یا جستجو در پایگاه داده شما. معیار پیشفرض برای ردیابی کد سفارشی مدت زمان آن است، اما میتوانید معیارهای سفارشی مانند بازدیدهای حافظه پنهان و هشدارهای حافظه را نیز اضافه کنید.
در کد خود، ابتدا و انتهای یک ردیابی کد سفارشی را با استفاده از API ارائه شده توسط Performance Monitoring SDK تعریف می کنید (و هر معیار دلخواه دلخواه را اضافه می کنید). برای برنامههای Android، میتوانید با استفاده از حاشیهنویسی @AddTrace، مدت زمان روشهای خاص را نیز نظارت کنید.
برای کسب اطلاعات بیشتر در مورد این ویژگیها و نحوه افزودن آنها به برنامهتان، از Add monitoring برای کد خاصی دیدن کنید.
مرحله 6 : برنامه خود را اجرا کنید و نتایج را بررسی کنید
پس از اینکه Performance Monitoring با استفاده از یک یا چند دستگاه آزمایشی تأیید کردید، میتوانید نسخه بهروز شده برنامه خود را برای کاربران خود اجرا کنید.
می توانید داده های عملکرد را در داشبورد عملکرد کنسول Firebase نظارت کنید.
مسائل شناخته شده
افزونه Performance Monitoring Gradle v1.1.0 می تواند باعث عدم تطابق در وابستگی های Guava شود که منجر به خطای زیر می شود:
Error:Execution failed for task ':app:packageInstantRunResourcesDebug'. > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;
اگر این خطا را مشاهده کردید، می توانید:
افزونه Performance Monitoring را به نسخه 1.1.1 یا جدیدتر ارتقا دهید (جدیدترین افزونه نسخه 1.4.2 است).
خط وابستگی افزونه Performance Monitoring را در فایل Gradle سطح ریشه (سطح پروژه) خود (
<project>/build.gradle.kts
یا<project>/build.gradle
) به صورت زیر جایگزین کنید:Kotlin
buildscript { // ... dependencies { // ... // Replace the standard Performance Monitoring plugin dependency line, as follows: classpath("com.google.firebase:perf-plugin:1.1.0") { exclude(group = "com.google.guava", module = "guava-jdk5") } } }
Groovy
buildscript { // ... dependencies { // ... // Replace the standard Performance Monitoring plugin dependency line, as follows: classpath('com.google.firebase:perf-plugin:1.1.0') { exclude group: 'com.google.guava', module: 'guava-jdk5' } } }
Performance Monitoring اندازه کل حجم بار برای درخواست های شبکه HTTP را بر اساس مقدار تنظیم شده در سربرگ طول محتوای HTTP گزارش می دهد. این مقدار ممکن است همیشه دقیق نباشد.
Performance Monitoring فقط از فرآیند اصلی در برنامههای چند فرآیندی اندروید پشتیبانی میکند.
مراحل بعدی
نمونه کد Performance Monitoring اندروید را در GitHub بررسی و اجرا کنید.
درباره داده هایی که به طور خودکار توسط Performance Monitoring جمع آوری می شود بیشتر بیاموزید:
- دادههای مربوط به چرخه عمر برنامهتان، مانند زمان شروع برنامه
- داده ها برای نمایش صفحه در برنامه شما
- دادههای درخواستهای شبکه HTTP/S که توسط برنامه شما صادر شده است
دادههای عملکرد خود را در کنسول Firebase مشاهده، ردیابی و فیلتر کنید .
با ابزار دقیق ردیابی کد سفارشی، نظارت برای وظایف یا گردشهای کاری خاص را در برنامه خود اضافه کنید.