跟踪

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

最新更新	稳定版本	候选版本	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 以来重要的更改

添加具有延迟字符串和 cookie 计算的 trace() 和 traceAsync() 变体。现在还可以在 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() API，用于在不可调试的构建中强制启用应用程序跟踪段捕获（即 android.os.Trace / androidx.tracing API）。在启动之初调用此方法，以便在 API 29 中引入可分析清单标签之前启用不可调试的准确系统跟踪。（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() API，用于在不可调试的构建中强制启用应用程序跟踪段捕获（即 android.os.Trace / andoridx.tracing API）。在启动之初调用此方法，以便在 API 29 中引入可分析清单标签之前启用不可调试的准确系统跟踪。（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。