Трассировка
| Последнее обновление | Основная версия | Релиз-кандидат | Бета-версия | Альфа-версия |
|---|---|---|---|---|
| 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теперь имеетminSdk24. (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(...), которая принимает тип JavaLong. (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, что приводило к появлению множества стрелок из-за неоднозначности того, какой фрагмент сопрограммы с чем связан. Вы по-прежнему можете вручную включить распространение с помощью APItokenForManualPropagation(), если это важно для вашего сценария использования. (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,PooledTracePacketArrayDelicateTracingApi. (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 содержит эти коммиты.
Исправление ошибок
Версия 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.