Отслеживание

Записывать события трассировки в системный буфер трассировки.
Последнее обновление Стабильный релиз Кандидат на релиз Бета-версия Альфа-релиз
19 ноября 2025 г. 1.3.0 - - -

Обратная связь

Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с уже существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав на кнопку со звёздочкой.

Создать новый выпуск

Более подробную информацию см. в документации по системе отслеживания проблем .

Версия 1.3

Версия 1.3.0

23 апреля 2025 г.

Выпущены androidx.tracing:tracing:1.3.0 , androidx.tracing:tracing-android:1.3.0 и androidx.tracing:tracing-ktx:1.3.0 . Версия 1.3.0 содержит эти коммиты .

Важные изменения с версии 1.2.0

  • Преобразовал класс androidx.tracing.Trace в Kotlin и перенес весь код из модуля tracing-ktx в tracing .
  • Удалить crossinline из трассировки, чтобы разрешить использование в @Composable . ( I53882 , b/248344805 )

Версия 1.3.0-rc01

9 апреля 2025 г.

androidx.tracing:tracing:1.3.0-rc01 , androidx.tracing:tracing-android:1.3.0-rc01 и androidx.tracing:tracing-ktx:1.3.0-rc01 выпущены без изменений с момента последней бета-версии. Версия 1.3.0-rc01 содержит эти коммиты .

Версия 1.3.0-beta01

12 февраля 2025 г.

Выпущены androidx.tracing:tracing:1.3.0-beta01 , androidx.tracing:tracing-android:1.3.0-beta01 и androidx.tracing:tracing-ktx:1.3.0-beta01 . Версия 1.3.0-beta01 содержит эти коммиты .

Изменения API

  • Перенес весь код из модуля tracing-ktx в tracing . ( Iba550 )
  • Преобразовал класс androidx.tracing.Trace в Kotlin. ( Ie4e5d )

Исправления ошибок

  • Удалено ручное описание доступа к новым API платформы, поскольку это происходит автоматически посредством моделирования API при использовании R8 с AGP 7.3 или более поздней версии (например, R8 версии 3.3) и для всех сборок с использованием AGP 8.1 или более поздней версии (например, D8 версии 8.1). Клиентам, не использующим AGP, рекомендуется обновиться до D8 версии 8.1 или более поздней. Подробнее см. в этой статье . ( Ia60e0 , b/345472586 )

Версия 1.3.0-альфа02

21 июня 2023 г.

androidx.tracing:tracing:1.3.0-alpha02 и androidx.tracing:tracing-ktx:1.3.0-alpha02 выпущены без изменений по сравнению с предыдущей альфа-версией. Версия 1.3.0-alpha02 содержит эти изменения.

Версия 1.3.0-альфа01

7 июня 2023 г.

Выпущены androidx.tracing:tracing:1.3.0-alpha01 и androidx.tracing:tracing-ktx:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит эти коммиты.

Изменения API

  • Удалить crossinline из трассировки, чтобы разрешить использование в @Composable . ( I53882 , b/248344805 )

Версия 1.2

Версия 1.2.0

29 ноября 2023 г.

Выпущены androidx.tracing:tracing:1.2.0 и androidx.tracing:tracing-ktx:1.2.0 . Версия 1.2.0 содержит эти коммиты.

Важные изменения с версии 1.1.0

  • Добавлены варианты trace() и traceAsync() с ленивым вычислением строк и файлов cookie. Также теперь Trace.end корректно пропускается, если Trace.begin выдаёт исключение.

Версия 1.2.0-rc01

24 мая 2023 г.

Выпущены androidx.tracing:tracing:1.2.0-rc01 и androidx.tracing:tracing-ktx:1.2.0-rc01 . Версия 1.2.0-rc01 содержит эти коммиты.

Исправления ошибок

  • Предотвращать сбои при передаче длинных имен разделов трассировки путем автоматического усечения ( Iaf6e2 )

Версия 1.2.0-beta04

3 мая 2023 г.

androidx.tracing:tracing:1.2.0-beta04 и androidx.tracing:tracing-ktx:1.2.0-beta04 выпущены без изменений. Версия 1.2.0-beta04 содержит эти коммиты.

Версия 1.2.0-beta03

5 апреля 2023 г.

androidx.tracing:tracing:1.2.0-beta03 и androidx.tracing:tracing-ktx:1.2.0-beta03 выпущены без новых изменений. Версия 1.2.0-beta03 содержит эти коммиты.

Версия 1.2.0-beta02

22 марта 2023 г.

androidx.tracing:tracing:1.2.0-beta02 и androidx.tracing:tracing-ktx:1.2.0-beta02 выпущены без изменений с момента предыдущей бета-версии. Версия 1.2.0-beta02 содержит эти изменения.

Версия 1.2.0-beta01

8 марта 2023 г.

androidx.tracing:tracing:1.2.0-beta01 и androidx.tracing:tracing-ktx:1.2.0-beta01 выпущены без изменений с момента последней альфа-версии. Версия 1.2.0-beta01 содержит эти изменения.

Версия 1.2.0-альфа02

23 февраля 2023 г.

androidx.tracing:tracing:1.2.0-alpha02 и androidx.tracing:tracing-ktx:1.2.0-alpha02 выпущены без изменений по сравнению с предыдущей альфа-версией. Версия 1.2.0-alpha02 содержит эти изменения.

Исправления ошибок

  • В этом выпуске будет исправлена ​​ошибка « Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02 при обновлении до androidx.tracing: tracing-perfetto-common:1.0.0-alpha11

Версия 1.2.0-альфа01

5 октября 2022 г.

Выпущены androidx.tracing:tracing:1.2.0-alpha01 и androidx.tracing:tracing-ktx:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит эти коммиты.

Новые функции

  • Добавлены варианты trace() и traceAsync() с ленивым вычислением строк и файлов cookie. Также теперь Trace.end корректно пропускается, если Trace.begin выдаёт исключение. ( I31421 , b/175233952 , b/247066503 )

Трассировка версии 1.1

Версия 1.1.0

11 мая 2022 г.

Выпущены androidx.tracing:tracing:1.1.0 и androidx.tracing:tracing-ktx:1.1.0 . Версия 1.1.0 содержит эти коммиты.

Важные изменения с версии 1.0.0

  • Добавлен API Trace.forceEnableAppTracing() для принудительного включения захвата разделов трассировки приложения (т. е. API android.os.Trace/androidx.tracing) в сборках без отладки. Вызывайте этот API в начале запуска, чтобы включить точную трассировку системы без отладки до появления профилируемого тега манифеста в API 29. ( I3a309 )
  • Избегайте ошибок проверки класса при первой загрузке Trace.java ( 05f6b4 и cb101f )

Версия 1.1.0-rc01

20 апреля 2022 г.

Выпущены androidx.tracing:tracing:1.1.0-rc01 и androidx.tracing:tracing-ktx:1.1.0-rc01 без каких-либо изменений с beta01 . Версия 1.1.0-rc01 содержит эти изменения.

Версия 1.1.0-beta01

1 декабря 2021 г.

Выпущены androidx.tracing:tracing:1.1.0-beta01 и androidx.tracing:tracing-ktx:1.1.0-beta01 . Версия 1.1.0-beta01 содержит эти коммиты.

Никаких изменений с 1.1.0-alpha02 .

Версия 1.1.0-альфа02

17 ноября 2021 г.

Выпущены androidx.tracing:tracing:1.1.0-alpha02 и androidx.tracing:tracing-ktx:1.1.0-alpha02 . Версия 1.1.0-alpha02 содержит эти коммиты.

Новые функции

  • Добавлен API Trace.forceEnableAppTracing() для принудительного включения захвата разделов трассировки приложения (т. е. API android.os.Trace/andoridx.tracing) в сборках без отладки. Вызовите этот API в начале запуска, чтобы включить точную трассировку системы без отладки до появления профилируемого тега манифеста в API 29. ( I3a309 )

Версия 1.1.0-альфа01

3 ноября 2021 г.

Выпущены androidx.tracing:tracing:1.1.0-alpha01 и androidx.tracing:tracing-ktx:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит эти коммиты.

Исправления ошибок

  • Избегайте ошибок проверки класса при первой загрузке Trace.java ( 05f6b4 и cb101f )

Отслеживание Перфетто версии 1.0.0

Версия 1.0.1

19 ноября 2025 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.1 , androidx.tracing:tracing-perfetto-binary:1.0.1 и androidx.tracing:tracing-perfetto-handshake:1.0.1 . Версия 1.0.1 содержит эти коммиты .

Исправления ошибок

  • Поддержка страниц размером 16 КБ ( b7a7dd )
  • Удалено ручное описание доступа к новым API платформы, поскольку это происходит автоматически посредством моделирования API при использовании R8 с AGP 7.3 или более поздней версии (например, R8 версии 3.3) и для всех сборок с использованием AGP 8.1 или более поздней версии (например, D8 версии 8.1). Клиентам, не использующим AGP, рекомендуется обновиться до D8 версии 8.1 или более поздней. Подробнее см. в этой статье . ( Ia60e0 , b/345472586 )
  • Избегайте объединения копий FastNative/CriticalNative в библиотеке и используйте стабильные копии платформы. ( I8238a , b/35664282 , b/280878596 )

Версия 1.0.0

4 октября 2023 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0 , androidx.tracing:tracing-perfetto-binary:1.0.0 и androidx.tracing:tracing-perfetto-handshake:1.0.0 . Версия 1.0.0 содержит эти коммиты.

Основные особенности версии 1.0.0

  • Это первый стабильный выпуск библиотек Tracing-perfetto.

Версия 1.0.0-rc01

20 сентября 2023 г.

androidx.tracing:tracing-perfetto:1.0.0-rc01 , androidx.tracing:tracing-perfetto-binary:1.0.0-rc01 и androidx.tracing:tracing-perfetto-handshake:1.0.0-rc01 выпущены без изменений с момента последней бета-версии. Версия 1.0.0-rc01 содержит эти коммиты.

Версия 1.0.0-beta03

30 августа 2023 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-beta03 , androidx.tracing:tracing-perfetto-binary:1.0.0-beta03 и androidx.tracing:tracing-perfetto-handshake:1.0.0-beta03 . Версия 1.0.0-beta03 содержит эти коммиты.

  • Повышение версии для соответствия выпуску androidx.benchmark.

Версия 1.0.0-beta02

23 августа 2023 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-beta02 , androidx.tracing:tracing-perfetto-binary:1.0.0-beta02 и androidx.tracing:tracing-perfetto-handshake:1.0.0-beta02 . Версия 1.0.0-beta02 содержит эти коммиты.

Новые функции

  • Включена поддержка трассировки при запуске приложения (холодный старт).

Версия 1.0.0-beta01

18 июля 2023 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-beta01 , androidx.tracing:tracing-perfetto-binary:1.0.0-beta01 и androidx.tracing:tracing-perfetto-handshake:1.0.0-beta01 . Версия 1.0.0-beta01 содержит эти коммиты.

Изменения API

  • androidx.tracing.perfetto.Trace переименован в androidx.tracing.perfetto.PerfettoSdkTrace ( I44af8 ).
  • Константы «код выхода» переименованы в «код результата» в протоколе для обеспечения согласованности ( Id1d1e ).
  • Переименован в EnableTracingResponse в Response . ( I56275 )
  • Добавлена ​​возможность включить трассировку холодного запуска в постоянном режиме. Добавлена ​​функция очистки (постоянной или нет) трассировки холодного запуска. ( Iaa09d )
  • API-интерфейсы Tracing Perfetto SDK приведены в соответствие с android.os.Trace . ( I73ba0 , b/282199917 )
  • Перенесено в шаблон фабрики для LibrarySource , что позволяет легко добавлять в API будущие варианты использования (например, прямую загрузку файла .so ) при необходимости. ( I128df )
  • Приведение параметров enableTracingColdStart в соответствие с enableTracingImmediate ( I54126 )
  • Удален аргумент killProcess в enableTracingColdStart ( I81c4d )

Версия 1.0.0-альфа17

21 июня 2023 г.

androidx.tracing:tracing-perfetto:1.0.0-alpha17 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17 и androidx.tracing:tracing-perfetto-handshake:1.0.0-alpha17 выпущены без изменений по сравнению с предыдущей альфа-версией. Версия 1.0.0-alpha17 содержит эти коммиты.

Версия 1.0.0-альфа16

7 июня 2023 г.

androidx.tracing:tracing-perfetto:1.0.0-alpha16 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha16 выпущены без изменений по сравнению с предыдущей альфа-версией. Версия 1.0.0-alpha16 содержит эти коммиты.

Версия 1.0.0-альфа15

3 мая 2023 г.

androidx.tracing:tracing-perfetto:1.0.0-alpha15 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha15 выпущены без изменений. Версия 1.0.0-alpha15 содержит эти коммиты.

Версия 1.0.0-альфа14

5 апреля 2023 г.

androidx.tracing:tracing-perfetto:1.0.0-alpha14 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha14 выпущены без каких-либо изменений. Версия 1.0.0-alpha14 содержит эти коммиты.

Версия 1.0.0-альфа13

22 марта 2023 г.

androidx.tracing:tracing-perfetto:1.0.0-alpha13 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha13 выпущены без изменений с момента предыдущего релиза. Версия 1.0.0-alpha13 содержит эти коммиты.

Версия 1.0.0-альфа12

8 марта 2023 г.

androidx.tracing:tracing-perfetto:1.0.0-alpha12 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha12 выпущены без изменений с момента предыдущей альфа-версии. Версия 1.0.0-alpha12 содержит эти коммиты.

Версия 1.0.0-альфа11

22 февраля 2023 г.

androidx.tracing:tracing-perfetto:1.0.0-alpha11 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha11 выпущены без изменений. Версия 1.0.0-alpha11 содержит эти коммиты.

Версия 1.0.0-альфа10

8 февраля 2023 г.

androidx.tracing:tracing-perfetto:1.0.0-alpha10 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha10 выпущены без изменений. Версия 1.0.0-alpha10 содержит эти коммиты.

Версия 1.0.0-альфа09

10 февраля 2023 г.

Выпущена версия androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09 . Версия 1.0.0-alpha09 содержит следующие коммиты.

Новые функции

  • Выпуск новой версии, позволяющий другим библиотекам androidx.tracing:tracing-perfetto*: 1.0.0-alpha09 работать вместе.

11 января 2023 г.

androidx.tracing:tracing-perfetto:1.0.0-alpha09 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha09 выпущены без изменений. Версия 1.0.0-alpha09 содержит эти коммиты.

Версия 1.0.0-альфа08

7 декабря 2022 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-alpha08 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha08 . Версия 1.0.0-alpha08 содержит эти коммиты.

Новые функции

  • Повышение производительности за счет оптимизации способа обработки строк.

Исправления ошибок

  • Добавлено правило proguard, предотвращающее удаление методов PerfettoNative , если класс вообще используется (предотвращает сбой в узкоспециализированном случае, когда трассировка инициализируется, но в приложении нет вызовов трассировки).

Версия 1.0.0-альфа07

9 ноября 2022 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-alpha07 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha07 . Версия 1.0.0-alpha07 содержит эти коммиты.

  • Сокращены накладные расходы JNI для API-интерфейсов androidx.tracing:tracing-perfetto .

Версия 1.0.0-альфа06

24 октября 2022 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-alpha06 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha06 . Версия 1.0.0-alpha06 содержит эти коммиты.

  • Это обновление не содержит никаких изменений, а лишь обновление номера версии для синхронизации с androidx.benchmark.

Версия 1.0.0-альфа05

5 октября 2022 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-alpha05 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha05 . Версия 1.0.0-alpha05 содержит эти коммиты.

Версия 1.0.0-альфа04

21 сентября 2022 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-alpha04 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha04 . Версия 1.0.0-alpha04 содержит эти коммиты.

Версия 1.0.0-альфа03

7 сентября 2022 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-alpha03 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha03 .

Новые функции

  • Никаких новых функций в версии 1.0.0-alpha02.

Версия 1.0.0-альфа02

24 августа 2022 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-alpha02 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит эти коммиты.

Исправления ошибок

  • Несколько улучшений инициализации сервиса Perfetto
  • Улучшена обработка случаев отсутствия ответа путем введения специального кода выхода: RESULT_CODE_CANCELLED.
  • Улучшена обработка ошибок анализа.
  • EnableTracingResponse.requiredVersion теперь допускает значение NULL, поскольку мы не можем узнать версию, если не можем связаться с пакетом. ( I5ba20 )

Версия 1.0.0-альфа01

27 июля 2022 г.

Выпущены androidx.tracing:tracing-perfetto:1.0.0-alpha01 , androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01 и androidx.tracing:tracing-perfetto-common:1.0.0-alpha01 . Версия 1.0.0-alpha01 содержит эти коммиты.

  • Примечание: Все библиотеки androidx.tracing:tracing-perfetto* изначально предназначены только для внутреннего использования в библиотеках AndroidX. Вам не следует полагаться на них напрямую.

Новые функции

  • Все библиотеки androidx.tracing:tracing-perfetto* изначально предназначены только для внутреннего использования в библиотеках AndroidX, и вам не следует полагаться на них напрямую. Мы документируем эти детали реализации для прозрачности.

  • androidx.tracing:tracing-perfetto — это библиотека, которая помогает создавать события трассировки с помощью Perfetto SDK с минимальными накладными расходами. Её можно использовать в Benchmark, Android Studio или Perfetto UI.

  • androidx.tracing:tracing-perfetto-binary — это набор двоичных зависимостей, необходимых для androidx.tracing:tracing-perfetto.

  • androidx.tracing:tracing-perfetto-common является внутренней зависимостью androidx.tracing:tracing-perfetto и может использоваться инструментами для интеграции с androidx.tracing:tracing-perfetto.

Трассировка версии 1.0.0

Версия 1.0.0

28 октября 2020 г.

Выпущены androidx.tracing:tracing:1.0.0 и androidx.tracing:tracing-ktx:1.0.0 . Версия 1.0.0 содержит эти коммиты.

Основные особенности версии 1.0.0

Помогает записывать события трассировки в системный буфер трассировки. Это можно визуализировать с помощью таких инструментов, как Systrace и Perfetto. Эта библиотека заменяет устаревший класс androidx.core.os.TraceCompat .

Версия 1.0.0-rc01

14 октября 2020 г.

Выпущены androidx.tracing:tracing:1.0.0-rc01 и androidx.tracing:tracing-ktx:1.0.0-rc01 . Версия 1.0.0-rc01 содержит эти коммиты.

Этот выпуск идентичен версии 1.0.0-beta01 .

Версия 1.0.0-beta01

24 июня 2020 г.

androidx.tracing:tracing:1.0.0-beta01 и androidx.tracing:tracing-ktx:1.0.0-beta01 выпущены без изменений с версии 1.0.0-alpha01 . Версия 1.0.0-beta01 содержит эти изменения.

Версия 1.0.0-альфа01

10 июня 2020 г.

Выпущены androidx.tracing:tracing:1.0.0-alpha01 и androidx.tracing:tracing-ktx:1.0.0-alpha01 . Версия 1.0.0-alpha01 содержит эти коммиты.

Новые функции

androidx.tracing — это библиотека, которая помогает записывать события трассировки в системный буфер трассировки. Их можно визуализировать с помощью таких инструментов, как Systrace и Perfetto. Эта библиотека заменяет устаревший класс androidx.core.os.TraceCompat . Первоначальная версия — 1.0.0-alpha01.