Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Метрики
Отслеживайте и сообщайте различные показатели времени выполнения вашего приложения.
| Последнее обновление | Стабильный релиз | Кандидат на релиз | Бета-версия | Альфа-релиз |
|---|
| 27 августа 2025 г. | - | - | 1.0.0-бета03 | - |
Объявление зависимостей
Чтобы добавить зависимость от Metrics, необходимо добавить репозиторий Google Maven в свой проект. Подробнее см. в репозитории Google Maven .
Добавьте зависимости для необходимых артефактов в файл build.gradle вашего приложения или модуля:
классный
dependencies {
implementation "androidx.metrics:metrics-performance:1.0.0-beta03"
} Котлин
dependencies {
implementation("androidx.metrics:metrics-performance:1.0.0-beta03")
} Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .
Обратная связь
Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с уже существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав на кнопку со звёздочкой.
Создать новый выпуск
Более подробную информацию см. в документации по системе отслеживания проблем .
Версия 1.0.0
Версия 1.0.0-beta03
27 августа 2025 г.
Выпущена androidx.metrics:metrics-performance:1.0.0-beta03 . Версия 1.0.0-beta03 содержит следующие изменения .
Исправления ошибок
- Исправлена
IllegalArgumentException («попытка удалить OnFrameMetricsAvailableListener , который не был добавлен»). Попытка записать синхронизацию кадра не выполняется, если окно не использует аппаратное ускорение, поскольку это не поддерживается Window.OnFrameMetricsAvailableListener . ( I8fef2 , b/436880904 )
Версия 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-альфа04
5 апреля 2023 г.
В этом выпуске JankStats обновлен до последних исправлений, которые включают более точную и полную информацию о времени.
Выпущена версия androidx.metrics:metrics-performance:1.0.0-alpha04 . Версия 1.0.0-alpha04 содержит следующие коммиты.
Изменения API
-
cpuDuration теперь более точная, также новая totalDuration в API31 ( I59ce8 , b/243694893 )
Версия 1.0.0-альфа03
27 июля 2022 г.
Выпущена androidx.metrics:metrics-performance:1.0.0-alpha03 . Версия 1.0.0-alpha03 содержит следующие изменения.
В этом выпуске содержатся незначительные улучшения API, связанные с приближением библиотеки к бета-версии. Одно из изменений API удаляет Executor из метода-фабрики createAndTrack() для создания объекта JankStats . Это влияет на обратный вызов OnFrameListener , поскольку этот прослушиватель теперь вызывается в потоке, который доставляет данные по кадрам в JankStats (поток Main/UI в версиях до API 24 и поток FrameMetrics в API 24+). Более того, объект FrameData , переданный прослушивателю, теперь используется повторно в каждом кадре, поэтому данные из этого объекта необходимо копировать и кэшировать в другом месте во время обратного вызова, поскольку этот объект должен считаться устаревшим сразу после возврата прослушивателя.
Также были исправлены различные ошибки, включая некоторые проблемы параллелизма.
Наконец, исправление для повторного использования FrameData (упомянутое выше) означает, что теперь нет необходимости выделять память на кадр из-за доставки метрик кадра. Раньше выделялось не так много памяти, но новый подход позволяет использовать JankStats без дополнительных затрат на сборку мусора на кадр в вашем приложении.
Изменения API
- Обновлены имена методов и параметров в
PerformanceMetricsState , чтобы сделать результаты этих вызовов более понятными. ( I56da5 , b/233421985 ) - Добавлены тесты для отслеживания распределения памяти, устранены некоторые внутренние распределения, связанные с управлением состоянием и отчётностью. Обратите внимание, что
FrameData , передаваемые слушателям, теперь считаются изменчивыми; эта структура будет повторно использована для следующего кадра, и данные остаются надёжными только до тех пор, пока слушатель не вернёт управление. - Удален Executor из конструктора
JankStats ; прослушиватели теперь вызываются в любом потоке, в котором были получены внутренние данные. ( I12743 )
Исправления ошибок
- Исправлен сбой из-за двойного удаления
OnFrameMetricsAvailableListener ( I44094 , b/239457413 ) - Вернуться к исходной логике размещения сообщений
OnPreDrawListener в начале очереди для более последовательной и предсказуемой синхронизации кадров. ( I05a43 , b/233358407 ) - Исправлена ошибка
ConcurrentModificationException , из-за которой список делегатов прослушивателя изменялся во время его итерации для отправки данных по кадрам. ( Ib7693 , b/236612357 )
Версия 1.0.0-альфа02
29 июня 2022 г.
Выпущена androidx.metrics:metrics-performance:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит следующие изменения.
Изменения API
Исправления ошибок
- Исправлена проблема синхронизации, из-за которой состояния могли быть заменены новыми значениями до обработки кадров, хотя старое состояние было бы правильным ( aosp/2061892 , b/213499234 )
- Исправлено исключение одновременного изменения при добавлении/удалении прослушивателей ( aosp/2092714 , b/213499234 )
- Расчеты startTime сделаны более точными ( aosp/2027704 , b/213245198 )
- Исправлена ошибка в реализации
FrameData.equals() ( aosp/2025866 , b/218296544 )
Версия 1.0.0-альфа01
9 февраля 2022 г.
Выпущена androidx.metrics:metrics-performance:1.0.0-alpha01 . Версия 1.0.0-alpha01 содержит следующие изменения.
Новые функции
- Библиотека
JankStats предоставляет функциональные возможности для измерения и получения обратных вызовов в вашем приложении во время выполнения, что может помочь обнаружить реальные проблемы с производительностью. -
JankStats сочетает в себе API, который позволяет легко вводить информацию о состоянии пользовательского интерфейса, с возможностями отслеживания и составления отчетов о производительности для каждого кадра, что позволяет разработчикам понять не только, есть ли у приложения проблемы с производительностью, но и когда и почему.
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-27 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-08-27 UTC."],[],[],null,["Metrics \nAPI Reference \n[androidx.metrics.performance](/reference/kotlin/androidx/metrics/performance/package-summary) \nTrack and report various runtime metrics for your application \n\n| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |\n|-----------------|----------------|-------------------|-----------------------------------------------------------------|---------------|\n| August 27, 2025 | - | - | [1.0.0-beta03](/jetpack/androidx/releases/metrics#1.0.0-beta03) | - |\n\nDeclaring dependencies\n\nTo add a dependency on Metrics, you must add the Google Maven repository to your\nproject. Read [Google's Maven repository](/studio/build/dependencies#google-maven)\nfor more information.\n\nAdd the dependencies for the artifacts you need in the `build.gradle` file for\nyour app or module: \n\nGroovy \n\n```groovy\ndependencies {\n implementation \"androidx.metrics:metrics-performance:1.0.0-beta03\"\n}\n```\n\nKotlin \n\n```kotlin\ndependencies {\n implementation(\"androidx.metrics:metrics-performance:1.0.0-beta03\")\n}\n```\n\nFor more information about dependencies, see [Add build dependencies](/studio/build/dependencies).\n\nFeedback\n\nYour feedback helps make Jetpack better. Let us know if you discover new issues or have\nideas for improving this library. Please take a look at the\n[existing issues](https://issuetracker.google.com/issues?q=componentid:1109743%20status:open)\nin this library before you create a new one. You can add your vote to an existing issue by\nclicking the star button.\n\n[Create a new issue](https://issuetracker.google.com/issues/new?component=1109743&template=1621342)\n\nSee the [Issue Tracker documentation](https://developers.google.com/issue-tracker)\nfor more information.\n\nVersion 1.0.0\n\nVersion 1.0.0-beta03\n\nAugust 27, 2025\n\n`androidx.metrics:metrics-performance:1.0.0-beta03` is released. Version 1.0.0-beta03 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/7a145e052ae61e272e91ffe285e9451b8ab71870..cd8ce2bdb21194a81a76325a8e65dad5d7e28681/metrics/metrics-performance).\n\n**Bug Fixes**\n\n- Fix `IllegalArgumentException`(\"attempt to remove `OnFrameMetricsAvailableListener` that was never added\"). No attempt is made to record frame timing when a window isn't hardware accelerated, as this isn't supported by `Window.OnFrameMetricsAvailableListener`. ([I8fef2](https://android-review.googlesource.com/#/q/I8fef2d16449a9a50a2092200d28e45baae537e22), [b/436880904](https://issuetracker.google.com/issues/436880904))\n\nVersion 1.0.0-beta02\n\nMarch 12, 2025\n\n`androidx.metrics:metrics-performance:1.0.0-beta02` is released. Version 1.0.0-beta02 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/7a45f0bc9e0a73744b3780a6f92e1b570de58bba..7a145e052ae61e272e91ffe285e9451b8ab71870/metrics/metrics-performance).\n\n**Bug Fixes**\n\n- Fix crashes `DelegatingFrameMetricsListener cannot be cast...` ([Id891c](https://android-review.googlesource.com/#/q/Id891c0cfdd7f45ef9e3b068644a113f39c8fc383), [b/311218678](https://issuetracker.google.com/issues/311218678)).\n\nVersion 1.0.0-beta01\n\nJanuary 10, 2024\n\nThe API and functionality of this library has been stable for some time. This release simply pushes the library to beta.\n\n`androidx.metrics:metrics-performance:1.0.0-beta01` is released. [Version 1.0.0-beta01 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/a200cb82769634cecdb118ec4f0bfdf0b086e597..7a45f0bc9e0a73744b3780a6f92e1b570de58bba/metrics/metrics-performance)\n\nVersion 1.0.0-alpha04\n\nApril 5, 2023\n\nThis release updates JankStats to the latest fixes, which include more accurate and comprehensive timing information.\n\n`androidx.metrics:metrics-performance:1.0.0-alpha04` is released. [Version 1.0.0-alpha04 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/a7f0710ad21f556f0dde9bf7bdab6d2135170fd4..a200cb82769634cecdb118ec4f0bfdf0b086e597/metrics/metrics-performance)\n\n**API Changes**\n\n- `cpuDuration` now more accurate, also new `totalDuration` on API31 ([I59ce8](https://android-review.googlesource.com/#/q/I59ce8c67f06a168f96893375c8aeca5516a55d81), [b/243694893](https://issuetracker.google.com/issues/243694893))\n\nVersion 1.0.0-alpha03\n\nJuly 27, 2022\n\n`androidx.metrics:metrics-performance:1.0.0-alpha03` is released. [Version 1.0.0-alpha03 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/8094b683499b4098092c01028b55a38b49e357f2..a7f0710ad21f556f0dde9bf7bdab6d2135170fd4/metrics/metrics-performance)\n\n- This release contains minor API refinements as the library gets closer to beta. One of the API changes removes the Executor from the `createAndTrack()` factory method for creating a `JankStats` object. This has implications for the `OnFrameListener` callback, as that listener is now called on the thread which delivers the per-frame data to `JankStats` (the Main/UI thread on versions earlier than API 24, and the `FrameMetrics` thread on API 24+). Moreover, the `FrameData` object passed to the listener is now reused every frame, so data from that object must be copied and cached elsewhere during the callback, as that object should be considered obsolete as soon as the listener returns.\n\n- There were also various bug fixes, including some concurrency issues.\n\n- Finally, the fix to reuse `FrameData` (mentioned above) means that there are now zero allocations per frame due to frame metrics delivery. There weren't many allocations before, but the new approach means that you can use `JankStats` without incurring any per-frame GC overhead in your app.\n\n**API Changes**\n\n- Updated method and parameter names in `PerformanceMetricsState` to make the results of those calls clearer. ([I56da5](https://android-review.googlesource.com/#/q/I56da57b13818bf4077a64ab144222ce255f4539a), [b/233421985](https://issuetracker.google.com/issues/233421985))\n- Added benchmark tests to track allocations, eliminated some internal allocations related to state management and reporting. Note that `FrameData` passed to listeners is now considered volatile; that structure will be reused for the next frame and the data is only reliable until the listener returns.\n- Removed Executor from constructor for `JankStats`; listeners are now called on whatever thread the internal data was received upon. ([I12743](https://android-review.googlesource.com/#/q/I1274320bf29c171b82578868e657a3b01f7805c7))\n\n**Bug Fixes**\n\n- Fixed crash due to double-removal of `OnFrameMetricsAvailableListener` ([I44094](https://android-review.googlesource.com/#/q/I4409483d6e2f7287a0a93f521f68a4be9e22d969), [b/239457413](https://issuetracker.google.com/issues/239457413))\n- Return to original logic of posting `OnPreDrawListener` messages at front of queue, for more consistent and predictable frame timing. ([I05a43](https://android-review.googlesource.com/#/q/I05a434fe9453ea1be28d398e3eb284dd9b0cb64a), [b/233358407](https://issuetracker.google.com/issues/233358407))\n- Fixed `ConcurrentModificationException` bug where the list of listener delegates was being modified while it was also being iterated through to send per-frame data. ([Ib7693](https://android-review.googlesource.com/#/q/Ib769386f18e51dc6b58c935b42c5b8566c644abc), [b/236612357](https://issuetracker.google.com/issues/236612357))\n\nVersion 1.0.0-alpha02\n\nJune 29, 2022\n\n`androidx.metrics:metrics-performance:1.0.0-alpha02` is released. [Version 1.0.0-alpha02 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/db2ecbef194afcddfaede22e1d884a8959a9277c..8094b683499b4098092c01028b55a38b49e357f2/metrics/metrics-performance)\n\n**API Changes**\n\n- Renamed `MetricsStateHolder` to just Holder (within `PerformanceMetricsState`): ([I5a4d9](https://android-review.googlesource.com/#/q/I5a4d9095520399a146e6fd78eb50c86a7051738b), [b/226565716](https://issuetracker.google.com/issues/226565716), [b/213499234](https://issuetracker.google.com/issues/213499234))\n\n**Bug Fixes**\n\n- Fixed timing issue where states could be replaced with new values before the frames had been processed where the old state would have been correct ([aosp/2061892](https://android-review.googlesource.com/c/platform/frameworks/support/+/2061892/), [b/213499234](https://issuetracker.google.com/issues/213499234))\n- Fixed concurrent modification exception in adding/removing listeners ([aosp/2092714](https://android-review.googlesource.com/c/platform/frameworks/support/+/2092714/), [b/213499234](https://issuetracker.google.com/issues/230388846))\n- Made startTime calculations more accurate ([aosp/2027704](https://android-review.googlesource.com/c/platform/frameworks/support/+/2027704/), [b/213245198](https://issuetracker.google.com/issues/213245198))\n- Fixed bug in `FrameData.equals()` implementation ([aosp/2025866](https://android-review.googlesource.com/c/platform/frameworks/support/+/2025866/), [b/218296544](https://issuetracker.google.com/issues/218296544))\n\nVersion 1.0.0-alpha01\n\nFebruary 9, 2022\n\n`androidx.metrics:metrics-performance:1.0.0-alpha01` is released. [Version 1.0.0-alpha01 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/db2ecbef194afcddfaede22e1d884a8959a9277c/metrics/metrics-performance)\n\n**New Features**\n\n- The `JankStats` library provides functionality to instrument and receive callbacks in your application at runtime which can help find real world performance problems.\n- `JankStats` combines an API that makes it easy to inject information about UI state with capabilities for tracking and reporting per-frame performance to allow developers to understand not whether an application has performance issues, but when and why."]]
