Трассировка

Записывайте события трассировки в буфер трассировки системы или фиксируйте трассировки внутри процесса с низкими накладными расходами.
Последнее обновление Основная версия Релиз-кандидат Бета-версия Альфа-версия
21 октября 2026 г. 2.0.5 - - -

Объявление зависимостей

Чтобы добавить зависимость от Tracing, необходимо добавить в проект репозиторий Google Maven. Подробную информацию можно найти в статье Репозиторий Google Maven.

Добавьте зависимости для нужных артефактов в файл build.gradle приложения или модуля:

Яркий

dependencies {
    def tracing_version = "2.0.5"

    // Core tracing API (for libraries and apps to emit trace events)
    implementation "androidx.tracing:tracing:$tracing_version"
    // In-process tracing backend and Perfetto sink (for apps)
    implementation "androidx.tracing:tracing-wire:$tracing_version"
    // Optional - Kotlin extensions for system tracing (only needed before 1.3.0; included in `tracing` since 1.3.0)
    implementation "androidx.tracing:tracing-ktx:$tracing_version"
}

Kotlin

dependencies {
    val tracing_version = "2.0.5"

    // Core tracing API (for libraries and apps to emit trace events)
    implementation("androidx.tracing:tracing:$tracing_version")
    // In-process tracing backend and Perfetto sink (for apps)
    implementation("androidx.tracing:tracing-wire:$tracing_version")
    // Optional - Kotlin extensions for system tracing (only needed before 1.3.0; included in `tracing` since 1.3.0)
    implementation("androidx.tracing:tracing-ktx:$tracing_version")
}

Подробнее о добавлении зависимостей сборки…

Отзыв

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

Как создать выпуск

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

Трассировка

Версия 2.0

Версия 2.0.5

21 октября 2026 г.

Данные "androidx.tracing:tracing-*:2.0.5" опубликованы. Версия 2.0.5 содержит эти коммиты.

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

  • Исправлено состояние гонки в управлении пулом, когда один и тот же поток мог одновременно сбрасывать и освобождать пакеты, что могло привести к взаимоблокировкам, особенно при использовании EmptyCoroutineContext. (Ia0aef48c, b/570135466)

Версия 2.0.4

12 октября 2026 г.

Данные "androidx.tracing:tracing-*:2.0.4" опубликованы. Версия 2.0.4 содержит эти коммиты.

Исправленные ошибки
  • Исправлено состояние гонки при сбросе пакетов трассировки. (aosp/4344047)

Версия 2.0.3

23 сентября 2026 г.

Данные "androidx.tracing:tracing-*:2.0.3" опубликованы. Версия 2.0.3 содержит эти коммиты.

Версия 2.0.2

9 сентября 2026 г.

Данные "androidx.tracing:tracing-*:2.0.2" опубликованы. Версия 2.0.2 содержит эти коммиты.

Версия 2.0.1

26 августа 2026 г.

Данные "androidx.tracing:tracing-*:2.0.1" опубликованы. Версия 2.0.1 содержит эти коммиты.

Версия 2.0.0

12 августа 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0" опубликованы. Версия 2.0.0 содержит эти коммиты.

Основные функции версии 2.0.0:

Новый API в процессе позволяет:

  • Запись содержимого трассировки в процессе, в поле
  • Потоки Perfetto (стрелки от одного фрагмента к другому).
  • Аннотации Perfetto (метаданные фрагментов в формате "ключ-значение")
  • traceCoroutine() {} – Coroutine Tracing API, который отслеживает переключение потоков.
  • Category filtering
  • Значительно меньшие накладные расходы, чем у существующего API android.os.Trace и оболочки trace() {}.
  • Отслеживание KMP. Можно использовать в библиотеках без зависимости от Android и в проектах хоста JVM.
  • Объединение с записью трассировки системы после выполнения (по умолчанию реализовано в AndroidX Benchmark 1.5).

Обратите внимание, что новые API трассировки записывают данные в буфер, управляемый процессом, который пока не захватывается записью трассировки системы Studio. Эта проблема будет устранена в одном из следующих выпусков Android Studio Profilers.

Поддержка существующих API android.os.Trace и trace() {} не прекращена. Эти API по-прежнему рекомендуются для редких событий, которые всегда должны записываться в буфер трассировки системы, особенно в библиотеках.

Версия 2.0.0-rc01

29 июля 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-rc01" опубликованы. Версия 2.0.0-rc01 содержит эти коммиты.

Версия 2.0.0-beta01

15 июля 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-beta01" опубликованы. Версия 2.0.0-beta01 содержит эти коммиты.

Изменения в API

  • PerfettoCapture и PerfettoTraceRule теперь могут записывать трассировки в процессе и объединять их для целевого пакета. (I9a00b, b/497959820)
  • androidx.benchmark теперь имеет minSdk 24. (Ic2a85)

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

  • Выпуск Tracing 2.0-beta01. (I1b162)
  • При создании информации об отслеживании используйте идентификаторы цепочек, относящиеся к конкретной платформе. (I6ba64)

Версия 2.0.0-alpha09

23 июня 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-alpha09" опубликованы. Версия 2.0.0-alpha09 содержит эти коммиты.

Изменения в API

  • Незначительное изменение API в Tracer, чтобы устранить неоднозначность между instant(...) и writeInstant(...). (I0935a)
  • Добавлена поддержка токенов распространения в мгновенных событиях. (I99f81)
  • Разрешить полное использование потоков Perfetto в экспериментальном API распространения контекста вручную. (I20cb6)
  • Отложите создание объектов BufferedSink и ProtoWriter в TraceSink. (Ibd098)
  • Упростите обнаружение Tracer и сделайте его подключаемым для библиотек Java и Android. (I99111)
  • Упростить для разработчиков библиотек поиск экземпляра TraceDriver, который можно использовать для трассировки в процессе. (Ia503e)

Версия 2.0.0-alpha08

19 мая 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-alpha08" опубликованы. Версия 2.0.0-alpha08 содержит эти коммиты.

Изменения в API

  • Добавлена возможность обнаруживать и переопределять экземпляры TraceDriver, которые будут использоваться во всем процессе. (I3f715)
  • Переименовать Tracer.recordException в Tracer.recordExceptionAndThrow. (I4411f, b/503092450)

Версия 2.0.0-alpha07

6 мая 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-alpha07" опубликованы. Версия 2.0.0-alpha07 содержит эти коммиты.

Изменения в API

  • Добавьте API, чтобы получить трассировщик-заглушку, который можно использовать, когда трассировка отключена. (I84c98)
  • Сделайте жизненный цикл трассировки согласованным с трассировкой системы. (Ib391b)
  • Counter API теперь полностью свободны от распределения. (I5e73a)

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

  • Исправлено правило keep для Perfetto SDK (tracing-perfetto), которое обеспечивает возможность включения Perfetto SDK. (I1d227)
  • Добавьте возможность отслеживать события flush(). (I38014, b/495852704)

Версия 2.0.0-alpha06

22 апреля 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-alpha06" опубликованы. Версия 2.0.0-alpha06 содержит эти коммиты.

Изменения в API

  • Снимите ограничение с File.createPerfettoFile(), чтобы другие пользователи могли безопасно создавать приемники. Если block() выдает исключение в trace/traceCoroutine, создайте событие instant для исключения с метаданными, представляющими соответствующие элементы трассировки стека. (I682e5, b/501536851, b/437166283)
  • Добавьте перегрузку setCounter(...), которая принимает тип Java Long. (Ic0469, b/356082604)
  • В Tracing 2.0 теперь используется Long для идентификаторов Thread, относящихся к платформе. (I67277)

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

  • Улучшить документацию для организации "AttributeEntry.reset()". (I5d3a1, b/496079439)

Версия 2.0.0-alpha05

8 апреля 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-alpha05" опубликованы. Версия 2.0.0-alpha05 содержит эти коммиты.

Изменения в API

  • Фабричные функции TraceSink теперь возвращают TraceSink, а не AbstractTraceSink. Теперь у файлов есть уникальный суффикс. Мы проверяем, что можем атомарно создать новый файл, который будет использоваться для хранения пакетов трассировки. (I4c4aa, b/496298726)
  • Упростите и ускорьте распространение контекста сопрограмм. (Ia62db)
  • Добавьте необязательный параметр attributes() при создании TraceDriver, чтобы можно было добавлять метаданные, относящиеся к трассировке. (Ia147e)

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

  • Потоки процессов и дорожки счетчиков теперь синхронизированы. Это исправляет исключения в форме: java.lang.NullPointerException: Cannot invoke "androidx.tracing.ThreadTrack.flush$tracing()" because "threadTrack" is null
  • Не генерировать события приемника, когда отслеживание отключено.

Версия 2.0.0-alpha04

25 марта 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-alpha04" опубликованы. Версия 2.0.0-alpha04 содержит эти коммиты.

Изменения в API

  • Сделайте AbstractTraceDriver по-настоящему абстрактным и переместите реализацию Perfetto в модуль tracing-wire. (Ie2f59)
  • Чтобы не ошибиться, давайте базовым реализациям более описательные названия. Разработчикам, которые ранее расширяли androidx.tracing.Trace{Sink|Driver}, теперь нужно перейти на AbstractTrace{Sink|Driver}. (I9b46d)

Версия 2.0.0-alpha03

11 марта 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-alpha03" опубликованы. Версия 2.0.0-alpha03 содержит эти коммиты.

Изменения в API

  • Добавлена экспериментальная реализация InMemoryRingBufferTraceSink, которая позволяет устанавливать ограничение емкости и избегать записи на диск без явного запроса. (I1dc44, b/484409653, I65a37, b/484409653)
  • Исправлено состояние гонки при отправке событий трассировки для приостановки и возобновления сопрограмм. (Ie145e)

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

  • androidx.tracing больше не пытается по умолчанию устанавливать связи между родительскими и дочерними сопрограммами в трассировках. Это вызывало путаницу, поскольку базовый формат трассировки не поддерживает связи 1:N и N:1, что приводило к появлению множества стрелок из-за неоднозначности того, какой фрагмент сопрограммы с чем связан. Вы по-прежнему можете вручную включить распространение с помощью API tokenForManualPropagation(), если это важно для вашего сценария использования. (Ib2cf9)

Версия 2.0.0-alpha02

25 февраля 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-alpha02" опубликованы. Версия 2.0.0-alpha02 содержит эти коммиты.

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

  • Повышена производительность реализации Perfetto Trace Sink за счет использования встроенной функции suspendCoroutineUninterceptedOrReturn (2ea97b).

Версия 2.0.0-alpha01

28 января 2026 г.

Данные "androidx.tracing:tracing-*:2.0.0-alpha01" опубликованы. Версия 2.0.0-alpha01 содержит эти коммиты.

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

В AndroidX Tracing 2.0 представлен новый API для внутрипроцессной трассировки с низкими накладными расходами, который дополняет существующие API на основе android.os.Tracing в Tracing 1.0. Новые API доступны как на Android, так и на хост-JVM, что позволяет хост-инструментам создавать трассировки с низкими накладными расходами для анализа производительности, используя тот же стандартный формат трассировки Perfetto.

Сгенерированные трассировки поддерживаются как Android Studio, так и Perfetto. Их можно записывать с расширенным набором функций, включая пометку фрагментов метаданными (например, аргументами функций) и распространение трассировки контекста сопрограммы.

Эта альфа-версия предназначена только для рабочих процессов трассировки в процессе и пока не интегрирована с трассировкой ОС Android или трассировкой системы Studio Profiler. Эти функции появятся в будущей альфа-версии.

  /**
  * A [TraceSink] defines how traces are serialized.
  *
  * [androidx.tracing.wire.TraceSink] uses the `Perfetto` trace packet format.
  */
  fun createSink(): TraceSink {
      val outputDirectory = File(/* pathname = */ "/tmp/perfetto")
      // We are using the factory function defined in androidx.tracing.wire
      return TraceSink(
          sequenceId = 1,
          directory = outputDirectory
      )
  }

  /**
  * Creates a new instance of [androidx.tracing.TraceDriver].
  */
  fun createTraceDriver(): TraceDriver {
      // We are using a factory function from androidx.tracing.wire here.
      // `isEnabled` controls whether tracing is enabled for the application.
      val driver = TraceDriver(sink = createSink(), isEnabled = true)
      return driver
  }

  fun main() {
      val driver = createTraceDriver()
      driver.use {
          driver.tracer.trace(category = CATEGORY_MAIN, name = "basic") {
              Thread.sleep(100L)
          }
      }
  }

Изменения в API

  • Сделайте Tracer свойством TraceDriver. (Iabd9b)
  • Добавлена поддержка ручной передачи контекста. (I899ff)
  • Добавьте возможность добавлять информацию о стеке вызовов в раздел трассировки. (If6a1b)
  • Представляем новые API androidx.tracing. (I5102b)
  • Разрешите мгновенным событиям содержать метаданные и добавьте счетчики к мгновенным событиям и счетчикам. (Ia2ed3)
  • Уменьшите область API, аннотированную с помощью @DelicateTracingApi. Ничто в API верхнего уровня не должно требовать использования @DelicateTracingApi. (I565e0)
  • Упростите распространение контекста, объединив PropagationToken. (Iab839)
  • Стабилизация API BlackHole в androidx.benchmark. (I2b67e, b/451749438)
  • Добавьте возможность аннотировать раздел трассировки как корневой интервал. (Ic8365)
  • Разработчик может явно указывать токены распространения. (I06bb1)
  • Название MetadataHandleCloseable изменено на EventMetadataCloseable, а MetadataHandle – на EventMetadata. Также в Tracer.traceCoroutine добавлен необязательный аргумент CoroutinePropagationToken, позволяющий разработчику явно указать токен распространения. (I219f7, b/454147392)
  • Добавлена новая точка входа Tracer, которая дает разработчикам больше контроля над трассировкой. (I24a7b)
  • Добавьте возможность управлять распространением контекста в SliceTrack. (Ieb8fc)
  • Функция fillCount в PooledTracePacketArray теперь правильно помечена как изменчивая. (I75d2c)
  • Отметить, что присутствие гостя MetadataEntry @DelicateTracingApi. (I8c723)
  • Добавьте возможность для TraceSink обрабатывать потерянные события трассировки (когда пул исчерпан). (I3b374)
  • Добавьте возможность условно генерировать события трассировки на основе предиката. (I621b4)
  • Добавьте возможность добавлять категории к событию трассировки. (I449c2)
  • Отметить, что TraceEvent, PooledTracePacketArray DelicateTracingApi. (Iaac6d)
  • Сделайте общедоступными ProcessTrack.id, ThreadTrack.id, ThreadTrack.name, CounterTrack.name и CounterTrack.parent. (I81210)
  • API SliceTrack.traceFlow() переименован в traceCoroutine(). (I79ad0)
  • Добавлена возможность добавлять контекстную информацию в срезы с помощью аннотаций отладки в трассировке Perfetto. (Ic2b56)
  • Добавьте возможность создавать экземпляр WireTraceSink с помощью File/OutputStream. (Iecea0)
  • Удалены устаревшие аннотации @RequiresApi(21) (Ic4792).

Версия 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 из trace, чтобы разрешить использование в @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-alpha02

21 июня 2023 г.

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

Версия 1.3.0-alpha01

7 июня 2023 г.

Данные "androidx.tracing:tracing:1.3.0-alpha01" и "androidx.tracing:tracing-ktx:1.3.0-alpha01" опубликованы. Версия 1.3.0-alpha01 содержит эти коммиты.

Изменения в API

  • Удалите crossinline из trace, чтобы разрешить использование в @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-alpha02

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-alpha01

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) в сборках, не предназначенных для отладки. Вызовите этот метод в начале запуска, чтобы включить точную трассировку системы без отладки до появления тега profileable в манифесте в 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-alpha02

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) в сборках, не предназначенных для отладки. Вызовите этот метод в начале запуска, чтобы включить точную трассировку системы без отладки до появления тега манифеста profileable в API 29. (I3a309)

Версия 1.1.0-alpha01

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

Версия 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-alpha01

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.

Perfetto для трассировки

Версия 1.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).
  • Для единообразия константы exit code в протоколе переименованы в result code (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-alpha17

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-alpha16

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-alpha15

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-alpha14

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-alpha13

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-alpha12

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-alpha11

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-alpha10

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-alpha09

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-alpha08

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-alpha07

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-alpha06

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-alpha05

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-alpha04

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-alpha03

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-alpha02

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-alpha01

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.