با Performance Monitoring برای Android شروع کنید

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

اگر شما در حال حاضر، اضافه فایربیس به پروژه آندروید خود را .

مرحله 1: اضافه کردن نظارت بر عملکرد SDK به برنامه شما

بعد از اینکه شما عملکرد نظارت SDK اضافه کرده ایم، به طور خودکار شروع فایربیس جمع آوری اطلاعات برای برنامه خود را ارائه صفحه نمایش و اطلاعات مربوط به چرخه عمر برنامه شما است (مانند برنامه زمان شروع ). برای فعال کردن فایربیس برای نظارت بر درخواست شبکه، شما همچنین باید نظارت بر عملکرد پلاگین Gradle (مرحله بعدی) اضافه کنید.

  1. با استفاده از فایربیس آندروید BOM ، اعلام وابستگی برای نظارت بر عملکرد کتابخانه آندروید در ماژول خود را (در سطح برنامه) فایل Gradle (معمولا app/build.gradle ).

    جاوا

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.3')
    
        // Declare 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'
    }
    

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

    (جایگزین) اعلام فایربیس وابستگی کتابخانه بدون استفاده از BOM

    اگر تصمیم گرفتید از Firebase BoM استفاده نکنید، باید هر نسخه کتابخانه Firebase را در خط وابستگی آن مشخص کنید.

    توجه داشته باشید که در صورت استفاده از کتابخانه فایربیس های متعدد در برنامه شما، ما به شدت توصیه با استفاده از BOM به مدیریت نسخه های کتابخانه، که تضمین می کند که تمام نسخه های سازگار است.

    dependencies {
        // Declare 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:20.0.4'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.3')
    
        // Declare 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-ktx'
    }
    

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

    (جایگزین) اعلام فایربیس وابستگی کتابخانه بدون استفاده از BOM

    اگر تصمیم گرفتید از Firebase BoM استفاده نکنید، باید هر نسخه کتابخانه Firebase را در خط وابستگی آن مشخص کنید.

    توجه داشته باشید که در صورت استفاده از کتابخانه فایربیس های متعدد در برنامه شما، ما به شدت توصیه با استفاده از BOM به مدیریت نسخه های کتابخانه، که تضمین می کند که تمام نسخه های سازگار است.

    dependencies {
        // Declare 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-ktx:20.0.4'
    }
    

  2. برنامه خود را دوباره کامپایل کنید

مرحله 2: اضافه کردن پلاگین نظارت بر عملکرد به برنامه شما

پس از عملکرد اضافه شده نظارت پلاگین Gradle، فایربیس به طور خودکار شروع به جمع آوری داده ها برای HTTP / S درخواست شبکه . این پلاگین همچنین شما را قادر به آثار کد سفارشی ساز با استفاده از حاشیه نویسیAddTrace .

  1. در ماژول خود را (در سطح برنامه) فایل Gradle (معمولا app/build.gradle )، اعمال می نظارت بر عملکرد پلاگین:

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services'
    // Apply the Performance Monitoring plugin
    apply plugin: 'com.google.firebase.firebase-perf'
    
    android {
      // ...
    }
    
  2. در خود ریشه در سطح (سطح پروژه) فایل Gradle ( build.gradle )، اضافه کردن قوانین شامل پلاگین عملکرد نظارت بر.

    buildscript {
    
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // Add the Bintray repository
          jcenter()
        }
    
        dependencies {
          // ...
    
          // To benefit from the latest Performance Monitoring plugin features,
          // update your Android Gradle Plugin dependency to at least v3.4.0
          classpath 'com.android.tools.build:gradle:3.4.0'
    
          classpath 'com.google.gms:google-services:4.3.10'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.4.0'  // Performance Monitoring plugin
        }
    }
    
  3. برنامه خود را دوباره کامپایل کنید

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

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

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

  2. رفتن به داشبورد عملکرد کنسول فایربیس. در عرض چند دقیقه باید نمایش داده های اولیه خود را ببینید.

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

گام 4: (اختیاری) نمایش پیام نگار برای رویدادهای عملکرد

  1. ورود به سیستم فعال اشکال زدایی برای نظارت بر عملکرد در زمان ساخت با اضافه کردن یک <meta-data> عنصر به برنامه خود را AndroidManifest.xml فایل، مانند:

    <application>
        <meta-data
          android:name="firebase_performance_logcat_enabled"
          android:value="true" />
    </application>
    
  2. پیام های گزارش خود را برای هرگونه پیام خطا بررسی کنید.

  3. نظارت بر عملکرد تگ پیام نگار با FirebasePerformance . با استفاده از فیلتر logcat، می توانید به طور خاص با اجرای دستور زیر، ردیابی مدت زمان و ثبت درخواست شبکه HTTP/S را مشاهده کنید:

    adb logcat -s FirebasePerformance
  4. انواع گزارش‌های زیر را بررسی کنید که نشان می‌دهد نظارت بر عملکرد، رویدادهای عملکرد را ثبت می‌کند:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  5. برای مشاهده داده های خود در کنسول Firebase روی URL کلیک کنید. ممکن است چند لحظه طول بکشد تا داده ها در داشبورد به روز شوند.

اگر برنامه شما است حوادث عملکرد ورود نکرده باشید، نکات عیبیابی .

مرحله 5: (اختیاری) اضافه کردن سفارشی نظارت برای کد خاص

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

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

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

مشاهده اضافه کردن نظارت برای کد خاص برای کسب اطلاعات بیشتر در مورد این ویژگی ها و چگونه به آنها اضافه کردن به برنامه شما.

مرحله 6: استقرار برنامه خود را پس از آن نتایج بررسی

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

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

مشکلات شناخته شده

  • افزونه 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.0 است).

    • به جای نظارت بر عملکرد پلاگین خط وابستگی خود را ریشه سطح (سطح پروژه) فایل Gradle ( build.gradle )، به شرح زیر:

      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'
          }
        }
      }
      
  • نظارت بر عملکرد، اندازه کل حجم بار برای درخواست های شبکه HTTP را بر اساس مقدار تنظیم شده در سربرگ طول محتوای HTTP گزارش می کند. این مقدار ممکن است همیشه دقیق نباشد.

  • مانیتورینگ عملکرد فقط از فرآیند اصلی در برنامه‌های چند فرآیندی اندروید پشتیبانی می‌کند.

مراحل بعدی