跟踪记录

  
将跟踪事件写入系统跟踪缓冲区。
最近更新时间 稳定版 候选版 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-alpha02androidx.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-alpha01androidx.tracing:tracing-ktx:1.3.0-alpha01版本 1.3.0-alpha01 中包含这些提交内容

API 变更

  • 从跟踪记录中移除了 crossinline,以便在 @Composable 中使用。(I53882b/248344805

版本 1.2

版本 1.2.0

2023 年 11 月 29 日

发布了 androidx.tracing:tracing:1.2.0androidx.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-rc01androidx.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-beta04androidx.tracing:tracing-ktx:1.2.0-beta04,没有任何变化。版本 1.2.0-beta04 中包含这些提交内容

版本 1.2.0-beta03

2023 年 4 月 5 日

发布了 androidx.tracing:tracing:1.2.0-beta03androidx.tracing:tracing-ktx:1.2.0-beta03,没有任何新更改。版本 1.2.0-beta03 中包含这些提交内容

版本 1.2.0-beta02

2023 年 3 月 22 日

发布了 androidx.tracing:tracing:1.2.0-beta02androidx.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-beta01androidx.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-alpha02androidx.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-alpha01androidx.tracing:tracing-ktx:1.2.0-alpha01版本 1.2.0-alpha01 中包含这些提交内容

新功能

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

Tracing 版本 1.1

版本 1.1.0

2022 年 5 月 11 日

发布了 androidx.tracing:tracing:1.1.0androidx.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 时出现类验证错误(05f6b4cb101f

版本 1.1.0-rc01

2022 年 4 月 20 日

发布了 androidx.tracing:tracing:1.1.0-rc01androidx.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-beta01androidx.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-alpha02androidx.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-alpha01androidx.tracing:tracing-ktx:1.1.0-alpha01版本 1.1.0-alpha01 中包含这些提交内容

bug 修复

  • 避免在首次加载 Trace.java 时出现类验证错误(05f6b4cb101f

Tracing Perfetto 版本 1.0.0

版本 1.0.0

2023 年 10 月 4 日

发布了 androidx.tracing:tracing-perfetto:1.0.0androidx.tracing:tracing-perfetto-binary:1.0.0androidx.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-rc01androidx.tracing:tracing-perfetto-binary:1.0.0-rc01androidx.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-beta03androidx.tracing:tracing-perfetto-binary:1.0.0-beta03androidx.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-beta02androidx.tracing:tracing-perfetto-binary:1.0.0-beta02androidx.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-beta01androidx.tracing:tracing-perfetto-binary:1.0.0-beta01androidx.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 一致。(I73ba0b/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-alpha17androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17androidx.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-alpha16androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16androidx.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-alpha15androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15androidx.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-alpha14androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14androidx.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-alpha13androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13androidx.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-alpha12androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12androidx.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-alpha11androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11androidx.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-alpha10androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10androidx.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-alpha09androidx.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-alpha08androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08androidx.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-alpha07androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07androidx.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-alpha06androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06androidx.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-alpha05androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05androidx.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-alpha04androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04androidx.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-alpha03androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03androidx.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-alpha02androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02androidx.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-alpha01androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01androidx.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.0androidx.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-rc01androidx.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-beta01androidx.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-alpha01androidx.tracing:tracing-ktx:1.0.0-alpha01版本 1.0.0-alpha01 中包含这些提交内容

新功能

androidx.tracing 是一个可帮助将跟踪事件写入系统跟踪缓冲区的库。可通过 Systrace 和 Perfetto 等工具直观呈现。此库会代替已废弃的 androidx.core.os.TraceCompat 类。此初始版本为 1.0.0-alpha01。