معیارها

معیارهای مختلف زمان اجرا را برای برنامه خود پیگیری و گزارش کنید
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
12 مارس 2025 - - 1.0.0-beta02 -

اعلام وابستگی ها

برای افزودن وابستگی به Metrics، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

dependencies {
    implementation "androidx.metrics:metrics-performance:1.0.0-beta02"
}

کاتلین 

dependencies {
    implementation("androidx.metrics:metrics-performance:1.0.0-beta02")
}

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

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه 1.0.0

نسخه 1.0.0-beta02

12 مارس 2025

androidx.metrics:metrics-performance:1.0.0-beta02 منتشر شد. نسخه 1.0.0-beta02 حاوی این تعهدات است.

رفع اشکال

  • رفع خرابی‌ها DelegatingFrameMetricsListener cannot be cast... ( Id891c ، b/311218678 ).

نسخه 1.0.0-beta01

10 ژانویه 2024

API و عملکرد این کتابخانه مدتی است که پایدار بوده است. این نسخه به سادگی کتابخانه را به سمت بتا سوق می دهد.

androidx.metrics:metrics-performance:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 حاوی این تعهدات است.

نسخه 1.0.0-alpha04

5 آوریل 2023

این نسخه JankStats را به آخرین اصلاحات، که شامل اطلاعات زمان دقیق تر و جامع تر است، به روز می کند.

androidx.metrics:metrics-performance:1.0.0-alpha04 منتشر شد. نسخه 1.0.0-alpha04 حاوی این commit ها است.

تغییرات API

  • cpuDuration اکنون دقیق تر است، همچنین totalDuration جدید در API31 ( I59ce8 , b/243694893 )

نسخه 1.0.0-alpha03

27 جولای 2022

androidx.metrics:metrics-performance:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 حاوی این commit ها است.

  • با نزدیک شدن کتابخانه به نسخه بتا، این نسخه شامل اصلاحات جزئی API است. یکی از تغییرات API، Executor را از متد کارخانه createAndTrack() برای ایجاد یک شی JankStats حذف می کند. این پیامدهایی برای پاسخ به تماس OnFrameListener دارد، زیرا آن شنونده اکنون در رشته ای فراخوانی می شود که داده های هر فریم را به JankStats تحویل می دهد (رشته اصلی/UI در نسخه های قبل از API 24 و رشته FrameMetrics در API 24+). علاوه بر این، شی FrameData که به شنونده ارسال می‌شود، اکنون در هر فریم مورد استفاده مجدد قرار می‌گیرد، بنابراین داده‌های آن شی باید کپی و در جای دیگری در حین فراخوانی ذخیره شوند، زیرا به محض بازگشت شنونده، آن شی باید منسوخ در نظر گرفته شود.

  • همچنین رفع اشکالات مختلفی از جمله برخی مشکلات همزمان وجود داشت.

  • در نهایت، اصلاح استفاده مجدد FrameData (که در بالا ذکر شد) به این معنی است که اکنون به دلیل تحویل معیارهای فریم، تخصیص به ازای هر فریم صفر است. قبلاً تخصیص های زیادی وجود نداشت، اما رویکرد جدید به این معنی است که می توانید از JankStats بدون متحمل شدن سربار GC برای هر فریم در برنامه خود استفاده کنید.

تغییرات API

  • نام روش ها و پارامترها را در PerformanceMetricsState به روز کرد تا نتایج آن تماس ها واضح تر شود. ( I56da5 , b/233421985 )
  • اضافه شدن تست‌های معیار برای پیگیری تخصیص‌ها، حذف برخی از تخصیص‌های داخلی مربوط به مدیریت و گزارش‌دهی ایالتی. توجه داشته باشید که FrameData که به شنوندگان ارسال می شود اکنون فرار در نظر گرفته می شود. آن ساختار برای فریم بعدی مجددا استفاده خواهد شد و داده ها فقط تا زمانی که شنونده برگردد قابل اعتماد است.
  • Executor از سازنده برای JankStats حذف شد. شنوندگان اکنون در هر رشته ای که داده های داخلی دریافت شده است فراخوانی می شوند. ( I12743 )

رفع اشکال

  • رفع خرابی به دلیل حذف دوبار OnFrameMetricsAvailableListener ( I44094 , b/239457413 )
  • برای زمان بندی فریم سازگارتر و قابل پیش بینی تر، به منطق اصلی ارسال پیام های OnPreDrawListener در جلوی صف بازگردید. ( I05a43 , b/233358407 )
  • رفع اشکال ConcurrentModificationException که در آن لیست نمایندگان شنونده در حالی که برای ارسال داده‌های هر فریم نیز تکرار می‌شد، اصلاح می‌شد. ( Ib7693 , b/236612357 )

نسخه 1.0.0-alpha02

29 ژوئن 2022

androidx.metrics:metrics-performance:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 حاوی این commit ها است.

تغییرات API

رفع اشکال

  • رفع مشکل زمان‌بندی که در آن حالت‌ها می‌توانستند قبل از پردازش فریم‌ها با مقادیر جدید جایگزین شوند، جایی که حالت قدیمی درست بود ( aosp/2061892 ، b/213499234 )
  • رفع استثناء اصلاح همزمان در افزودن/حذف شنوندگان ( aosp/2092714 ، b/213499234 )
  • محاسبات startTime را دقیق تر کرد ( aosp/2027704 , b/213245198 )
  • رفع اشکال در اجرای FrameData.equals() ( aosp/2025866 , b/218296544 )

نسخه 1.0.0-alpha01

9 فوریه 2022

androidx.metrics:metrics-performance:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 حاوی این commit ها است.

ویژگی های جدید

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