跟踪

将跟踪事件写入系统跟踪缓冲区。

最新更新	稳定版本	发布候选版本	Beta 版本	Alpha 版本
2023 年 11 月 29 日	1.2.0	-	-	1.3.0-alpha02

反馈

您的反馈有助于改进 Jetpack。如果您发现新问题或有改进此库的想法，请告知我们。在创建新问题之前，请查看此库中的现有问题。您可以通过单击星形按钮为现有问题添加您的投票。

创建新问题

有关更多信息，请参阅问题跟踪器文档。

版本 1.3

版本 1.3.0-alpha02

2023 年 6 月 21 日

androidx.tracing:tracing:1.3.0-alpha02 和 androidx.tracing:tracing-ktx:1.3.0-alpha02 已发布，与之前的 Alpha 版本相比没有任何变化。版本 1.3.0-alpha02 包含这些提交。

版本 1.3.0-alpha01

2023 年 6 月 7 日

androidx.tracing:tracing:1.3.0-alpha01 和 androidx.tracing:tracing-ktx:1.3.0-alpha01 已发布。版本 1.3.0-alpha01 包含这些提交。

API 更改

从 trace 中删除 crossinline 以允许在 @Composable 中使用。(I53882，b/248344805)

版本 1.2

版本 1.2.0

2023 年 11 月 29 日

androidx.tracing:tracing:1.2.0 和 androidx.tracing:tracing-ktx:1.2.0 已发布。版本 1.2.0 包含这些提交。

自 1.1.0 以来重要的更改

添加 trace() 和 traceAsync() 变体，具有延迟字符串和 cookie 计算。现在如果 Trace.begin 抛出异常，也会正确跳过 Trace.end。

版本 1.2.0-rc01

2023 年 5 月 24 日

androidx.tracing:tracing:1.2.0-rc01 和 androidx.tracing:tracing-ktx:1.2.0-rc01 已发布。版本 1.2.0-rc01 包含这些提交。

错误修复

通过自动截断来防止长跟踪部分名称传递时崩溃 (Iaf6e2)

版本 1.2.0-beta04

2023 年 5 月 3 日

androidx.tracing:tracing:1.2.0-beta04 和 androidx.tracing:tracing-ktx:1.2.0-beta04 发布，无变更。版本 1.2.0-beta04 包含这些提交。

版本 1.2.0-beta03

2023 年 4 月 5 日

androidx.tracing:tracing:1.2.0-beta03 和 androidx.tracing:tracing-ktx:1.2.0-beta03 发布，无变更。版本 1.2.0-beta03 包含这些提交。

版本 1.2.0-beta02

2023 年 3 月 22 日

androidx.tracing:tracing:1.2.0-beta02 和 androidx.tracing:tracing-ktx:1.2.0-beta02 发布，自上次 beta 版以来无变更。版本 1.2.0-beta02 包含这些提交。

版本 1.2.0-beta01

2023 年 3 月 8 日

androidx.tracing:tracing:1.2.0-beta01 和 androidx.tracing:tracing-ktx:1.2.0-beta01 发布，自上次 alpha 版以来无变更。版本 1.2.0-beta01 包含这些提交。

版本 1.2.0-alpha02

2023 年 2 月 23 日

androidx.tracing:tracing:1.2.0-alpha02 和 androidx.tracing:tracing-ktx:1.2.0-alpha02 发布，自上次 alpha 版以来无变更。版本 1.2.0-alpha02 包含这些提交。

错误修复

此版本将修复升级到 androidx.tracing: tracing-perfetto-common:1.0.0-alpha11 时出现的 Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02 错误。

版本 1.2.0-alpha01

2022 年 10 月 5 日

androidx.tracing:tracing:1.2.0-alpha01 和 androidx.tracing:tracing-ktx:1.2.0-alpha01 发布。版本 1.2.0-alpha01 包含这些提交。

新增功能

添加了 trace() 和 traceAsync() 变体，它们具有延迟字符串和 cookie 计算功能。此外，如果 Trace.begin 抛出异常，现在会正确跳过 Trace.end。（I31421，b/175233952，b/247066503）

追踪版本 1.1

版本 1.1.0

2022 年 5 月 11 日

androidx.tracing:tracing:1.1.0 和 androidx.tracing:tracing-ktx:1.1.0 发布。版本 1.1.0 包含这些提交。

自 1.0.0 以来重要更改

添加了 Trace.forceEnableAppTracing()，一个强制在不可调试构建中启用应用程序跟踪部分捕获（即 android.os.Trace / androidx.tracing API）的 API。在启动开始时调用此 API，以在 API 29 中引入 profileable 清单标签之前，启用不可调试的精确系统跟踪。（I3a309）
避免 Trace.java 首次加载时出现类验证错误（05f6b4 和 cb101f）

版本 1.1.0-rc01

2022 年 4 月 20 日

androidx.tracing:tracing:1.1.0-rc01 和 androidx.tracing:tracing-ktx:1.1.0-rc01 发布，自 beta01 以来无变更。版本 1.1.0-rc01 包含这些提交。

版本 1.1.0-beta01

2021 年 12 月 1 日

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

2021 年 11 月 17 日

androidx.tracing:tracing:1.1.0-alpha02 和 androidx.tracing:tracing-ktx:1.1.0-alpha02 发布。版本 1.1.0-alpha02 包含这些提交。

新增功能

添加了 Trace.forceEnableAppTracing()，一个强制在不可调试构建中启用应用程序跟踪部分捕获（即 android.os.Trace / andoridx.tracing API）的 API。在启动开始时调用此 API，以在 API 29 中引入 profileable 清单标签之前，启用不可调试的精确系统跟踪。（I3a309）

版本 1.1.0-alpha01

2021 年 11 月 3 日

androidx.tracing:tracing:1.1.0-alpha01 和 androidx.tracing:tracing-ktx:1.1.0-alpha01 发布。版本 1.1.0-alpha01 包含这些提交。

错误修复

避免 Trace.java 首次加载时出现类验证错误（05f6b4 和 cb101f）

追踪 Perfetto 版本 1.0.0

版本 1.0.0

2023 年 10 月 4 日

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

2023 年 9 月 20 日

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 发布，自上次 beta 版以来无变更。版本 1.0.0-rc01 包含这些提交。

版本 1.0.0-beta03

2023 年 8 月 30 日

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

2023 年 8 月 23 日

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

2023 年 7 月 18 日

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)
使 Tracing Perfetto SDK API 与 android.os.Trace 保持一致。（I73ba0，b/282199917)
将 LibrarySource 迁移到工厂模式，允许在需要时轻松将未来的用例（例如直接加载 .so 文件）添加到 API 中。（I128df)
使 enableTracingColdStart 参数与 enableTracingImmediate 相匹配 (I54126)
删除了 enableTracingColdStart 中的 killProcess 参数 (I81c4d)

版本 1.0.0-alpha17

2023 年 6 月 21 日

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 发布，自上次 alpha 版以来无变更。版本 1.0.0-alpha17 包含这些提交。

版本 1.0.0-alpha16

2023 年 6 月 7 日

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 发布，自上次 alpha 版以来无变更。版本 1.0.0-alpha16 包含这些提交。

版本 1.0.0-alpha15

2023 年 5 月 3 日

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

2023 年 4 月 5 日

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

2023 年 3 月 22 日

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

2023 年 3 月 8 日

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 发布，自上次 alpha 版以来无变更。版本 1.0.0-alpha12 包含这些提交。

版本 1.0.0-alpha11

2023 年 2 月 22 日

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

2023 年 2 月 8 日

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

2023 年 2 月 10 日

androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09 发布。版本 1.0.0-alpha09 包含这些提交。

新增功能

版本升级发布，允许其他 androidx.tracing:tracing-perfetto*: 1.0.0-alpha09 库协同工作。

2023 年 1 月 11 日

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

2022 年 12 月 7 日

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

2022 年 11 月 9 日

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 包含这些提交。

减少了 androidx.tracing:tracing-perfetto API 的 JNI 开销。

版本 1.0.0-alpha06

2022 年 10 月 24 日

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

2022 年 10 月 5 日

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

2022 年 9 月 21 日

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

2022 年 9 月 7 日

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

2022 年 8 月 24 日

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

2022 年 7 月 27 日

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

2020 年 10 月 28 日

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

2020 年 10 月 14 日

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

2020 年 6 月 24 日

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

2020 年 6 月 10 日

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。