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

Записывайте события трассировки в системный буфер трассировки.
Последнее обновление Стабильный выпуск Кандидат на выпуск Бета-версия Альфа-релиз
23 апреля 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 , б / 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-бета01

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 . ( Иба550 )
  • Класс 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 , б/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 , б / 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-бета04

3 мая 2023 г.

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

Версия 1.2.0-бета03

5 апреля 2023 г.

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

Версия 1.2.0-бета02

22 марта 2023 г.

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

Версия 1.2.0-бета01

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 , б / 175233952 , б / 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

  • Добавлен Trace.forceEnableAppTracing() API для принудительного включения захвата раздела трассировки приложения (т. е. API android.os.Trace/androidx.tracing) в неотлаживаемых сборках. Вызовите это в начале запуска, чтобы включить неотлаживаемую точную трассировку системы перед введением профилируемого тега манифеста в 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-бета01

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 содержит эти коммиты.

Новые возможности

  • Добавлен Trace.forceEnableAppTracing() API для принудительного включения захвата раздела трассировки приложения (т. е. API android.os.Trace/andoridx.tracing) в неотлаживаемых сборках. Вызовите это в начале запуска, чтобы включить неотлаживаемую точную трассировку системы перед введением профилируемого тега манифеста в 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.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-бета03

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-бета01

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 , б/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 обнуляемым, поскольку мы не можем узнать версию, если не можем связаться с пакетом. ( 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.

  • 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-бета01

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.