跟踪记录

  
将跟踪事件写入系统跟踪缓冲区。
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2025 年 4 月 23 日 1.3.0 - - -

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 1.3

版本 1.3.0

2025 年 4 月 23 日

发布了 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、b/248344805）

版本 1.3.0-rc01

2025 年 4 月 9 日

发布了 androidx.tracing:tracing:1.3.0-rc01、androidx.tracing:tracing-android:1.3.0-rc01 和 androidx.tracing:tracing-ktx:1.3.0-rc01，这三个版本与上个 Beta 版相比没有变化。版本 1.3.0-rc01 包含这些提交内容。

版本 1.3.0-beta01

2025 年 2 月 12 日

发布了 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)

bug 修复

  • 移除了手动说明对新平台 API 的访问权限，因为当将 R8 与 AGP 7.3 或更高版本（例如 R8 版本 3.3）搭配使用时，系统会通过 API 建模自动执行此操作；当使用 AGP 8.1 或更高版本（例如 D8 版本 8.1）时，系统会针对所有 build 自动执行此操作。建议不使用 AGP 的客户更新到 D8 8.1 或更高版本。如需了解详情，请参阅这篇文章。（Ia60e0、b/345472586）

版本 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 变更

  • 从轨迹中移除了 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 中包含这些提交内容。

bug 修复

  • 通过自动截断，防止在传递长跟踪部分名称时发生崩溃 (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 中包含这些提交内容。

bug 修复

  • 此版本将修复升级到 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 中包含这些提交内容。

新功能

  • 添加了采用延迟字符串和 Cookie 计算的 trace() 和 traceAsync() 变体。现在，如果抛出 Trace.begin，还会正确跳过 Trace.end。（I31421、b/175233952、b/247066503）

Tracing 版本 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，用于在不可调试的 build 上强制启用应用轨迹部分捕获（即 android.os.Trace/androidx.tracing API）。在 API 29 中引入可分析的清单标记之前，在启动开始时调用此 API 即可启用不可调试的准确系统跟踪。(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，用于在不可调试的 build 上强制启用应用轨迹部分捕获（即 android.os.Trace/andoridx.tracing API）。在 API 29 中引入可分析的清单标记之前，在启动开始时调用此 API 即可启用不可调试的准确系统跟踪。(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 中包含这些提交内容。

bug 修复

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

Tracing 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 中包含这些提交内容。

新功能

  • bump 版本，可让其他 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 中包含这些提交内容。

新功能

  • 通过优化字符串的处理方式提高了性能。

bug 修复

  • 添加了一条 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 中包含这些提交内容。

bug 修复

  • 对 Perfetto 服务初始化进行了多项改进
  • 通过引入专用退出代码 CASE_CODE_CANCELLED 改进了对无响应情况的处理。
  • 改进了对解析错误的处理方式。
  • 使 EnableTracingResponse.requiredVersion 可为 null，因为如果我们无法与软件包通信，就无法知道版本。(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 界面中使用。

  • androidx.tracing:tracing-perfetto-binary 是 androidx.tracing:tracing-perfetto 所需的一组二进制文件依赖项。

  • androidx.tracing:tracing-perfetto-common 是 androidx.tracing:tracing-perfetto 的内部依赖项，可供工具使用，以与 androidx.tracing:tracing-perfetto 集成。

Tracing 版本 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。