Tracing

  
Programe eventos de rastreamento no buffer de rastreamento do sistema.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
23 de abril de 2025 1.3.0 - - -

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.3

Versão 1.3.0

23 de abril de 2025

Lançamento de androidx.tracing:tracing:1.3.0, androidx.tracing:tracing-android:1.3.0 e androidx.tracing:tracing-ktx:1.3.0. A versão 1.3.0 contém estas confirmações.

Mudanças importantes desde a versão 1.2.0

  • A classe androidx.tracing.Trace foi convertida em Kotlin, e todo o código do módulo tracing-ktx foi movido para tracing.
  • O crossinline foi removido do rastreamento para permitir o uso em um @Composable. (I53882, b/248344805).

Versão 1.3.0-rc01

9 de abril de 2025

Lançamento de androidx.tracing:tracing:1.3.0-rc01, androidx.tracing:tracing-android:1.3.0-rc01 e androidx.tracing:tracing-ktx:1.3.0-rc01 sem mudanças desde a última versão Beta. A versão 1.3.0-rc01 contém estas confirmações.

Versão 1.3.0-beta01

12 de fevereiro de 2025

Lançamento de androidx.tracing:tracing:1.3.0-beta01, androidx.tracing:tracing-android:1.3.0-beta01 e androidx.tracing:tracing-ktx:1.3.0-beta01. A versão 1.3.0-beta01 contém estas confirmações.

Mudanças na API

  • Todo o código do módulo tracing-ktx foi movido para tracing. (Iba550).
  • A classe androidx.tracing.Trace foi convertida em Kotlin. (Ie4e5d).

Correções de bugs

  • O contorno manual de acesso a novas APIs da plataforma foi removido, já que isso acontece automaticamente pelo modelagem de API ao usar o R8 com o AGP 7.3 ou mais recente (por exemplo, o R8 versão 3.3) e para todos os builds ao usar o AGP 8.1 ou mais recente (por exemplo, o D8 versão 8.1). Os clientes que não estão usando o AGP precisam fazer upgrade para a versão 8.1 ou mais recente do D8. Veja mais detalhes neste artigo. (Ia60e0, b/345472586).

Versão 1.3.0-alpha02

21 de junho de 2023

Lançamento de androidx.tracing:tracing:1.3.0-alpha02 e androidx.tracing:tracing-ktx:1.3.0-alpha02, sem mudanças desde a versão Alfa anterior. A versão 1.3.0-alpha02 contém estas confirmações.

Versão 1.3.0-alpha01

7 de junho de 2023

Lançamento de androidx.tracing:tracing:1.3.0-alpha01 e androidx.tracing:tracing-ktx:1.3.0-alpha01. A versão 1.3.0-alpha01 contém estas confirmações.

Mudanças na API

  • A crossinline foi removida do trace para permitir o uso em um @Composable. (I53882, b/248344805).

Versão 1.2

Versão 1.2.0

29 de novembro de 2023

Lançamento de androidx.tracing:tracing:1.2.0 e androidx.tracing:tracing-ktx:1.2.0. A versão 1.2.0 contém estas confirmações.

Mudanças importantes desde a 1.1.0

  • As variantes trace() e traceAsync() foram adicionadas com computação lenta de strings e cookies. Agora, Trace.end também vai ser pulado corretamente se Trace.begin for gerado

Versão 1.2.0-rc01

24 de maio de 2023

Lançamento de androidx.tracing:tracing:1.2.0-rc01 e androidx.tracing:tracing-ktx:1.2.0-rc01. A versão 1.2.0-rc01 contém estas confirmações.

Correções de bugs

  • Evita falhas quando nomes de seções de rastreamento longos são transmitidos por truncamento automático (Iaf6e2).

Versão 1.2.0-beta04

3 de maio de 2023

Lançamento de androidx.tracing:tracing:1.2.0-beta04 e androidx.tracing:tracing-ktx:1.2.0-beta04, sem mudanças. A versão 1.2.0-beta04 contém estas confirmações.

Versão 1.2.0-beta03

5 de abril de 2023

Lançamento de androidx.tracing:tracing:1.2.0-beta03 e androidx.tracing:tracing-ktx:1.2.0-beta03, sem novas mudanças. A versão 1.2.0-beta03 contém estas confirmações.

Versão 1.2.0-beta02

22 de março de 2023

Lançamento de androidx.tracing:tracing:1.2.0-beta02 e androidx.tracing:tracing-ktx:1.2.0-beta02, sem mudanças desde a versão Beta anterior. A versão 1.2.0-beta02 contém estas confirmações.

Versão 1.2.0-beta01

8 de março de 2023

Lançamento de androidx.tracing:tracing:1.2.0-beta01 e androidx.tracing:tracing-ktx:1.2.0-beta01, sem mudanças desde a última versão Alfa. A versão 1.2.0-beta01 contém estas confirmações.

Versão 1.2.0-alpha02

23 de fevereiro de 2023

Lançamento de androidx.tracing:tracing:1.2.0-alpha02 e androidx.tracing:tracing-ktx:1.2.0-alpha02, sem mudanças desde a versão Alfa anterior. A versão 1.2.0-alpha02 contém estas confirmações.

Correções de bugs

  • Esta versão vai corrigir um erro Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02 ao fazer upgrade para androidx.tracing: tracing-perfetto-common:1.0.0-alpha11.

Versão 1.2.0-alpha01

5 de outubro de 2022

Lançamento de androidx.tracing:tracing:1.2.0-alpha01 e androidx.tracing:tracing-ktx:1.2.0-alpha01. A versão 1.2.0-alpha01 contém estas confirmações.

Novos recursos

  • As variantes trace() e traceAsync() foram adicionadas com computação lenta de strings e cookies. Agora, Trace.end também vai ser pulado corretamente se Trace.begin for gerado (I31421, b/175233952, b/247066503).

Tracing: versão 1.1

Versão 1.1.0

11 de maio de 2022

Lançamento de androidx.tracing:tracing:1.1.0 e androidx.tracing:tracing-ktx:1.1.0. A versão 1.1.0 contém estas confirmações.

Mudanças importantes desde a versão 1.0.0

  • A API Trace.forceEnableAppTracing() foi adicionada para forçar a ativação da captura de seção de rastreamento de apps (ou seja, APIs android.os.Trace / androidx.tracing) em builds não depuráveis. Chame essa API no começo da inicialização para ativar o rastreamento preciso e não depurável do sistema antes da introdução da tag de manifesto que pode gerar perfis na API 29 (I3a309).
  • Os erros de verificação de classe não ocorrem mais quando o Trace.java é carregado pela primeira vez (05f6b4 e cb101f).

Versão 1.1.0-rc01

20 de abril de 2022

Lançamento de androidx.tracing:tracing:1.1.0-rc01 e androidx.tracing:tracing-ktx:1.1.0-rc01, sem mudanças desde a beta01. A versão 1.1.0-rc01 contém estas confirmações.

Versão 1.1.0-beta01

1º de dezembro de 2021

Lançamento de androidx.tracing:tracing:1.1.0-beta01 e androidx.tracing:tracing-ktx:1.1.0-beta01. A versão 1.1.0-beta01 contém estas confirmações.

Nenhuma mudança desde a versão 1.1.0-alpha02.

Versão 1.1.0-alpha02

17 de novembro de 2021

Lançamento de androidx.tracing:tracing:1.1.0-alpha02 e androidx.tracing:tracing-ktx:1.1.0-alpha02. A versão 1.1.0-alpha02 contém estas confirmações.

Novos recursos

  • A API Trace.forceEnableAppTracing() foi adicionada para forçar a ativação da captura de seção de rastreamento de apps (ou seja, APIs android.os.Trace / androidx.tracing) em builds não depuráveis. Chame essa API no começo da inicialização para ativar o rastreamento preciso e não depurável do sistema antes da introdução da tag de manifesto que pode gerar perfis na API 29 (I3a309).

Versão 1.1.0-alpha01

3 novembro de 2021

Lançamento de androidx.tracing:tracing:1.1.0-alpha01 e androidx.tracing:tracing-ktx:1.1.0-alpha01. A versão 1.1.0-alpha01 contém estas confirmações.

Correções de bugs

  • Os erros de verificação de classe não ocorrem mais quando o Trace.java é carregado pela primeira vez (05f6b4 e cb101f).

Tracing Perfetto: versão 1.0.0

Versão 1.0.0

4 de outubro de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0, androidx.tracing:tracing-perfetto-binary:1.0.0 e androidx.tracing:tracing-perfetto-handshake:1.0.0. A versão 1.0.0 contém estas confirmações.

Principais recursos da versão 1.0.0

  • Esta é a primeira versão estável das bibliotecas do Tracing-perfetto.

Versão 1.0.0-rc01

20 de setembro de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-rc01, androidx.tracing:tracing-perfetto-binary:1.0.0-rc01 e androidx.tracing:tracing-perfetto-handshake:1.0.0-rc01 sem mudanças desde a última versão Beta. A versão 1.0.0-rc01 contém estas confirmações.

Versão 1.0.0-beta03

30 de agosto de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-beta03, androidx.tracing:tracing-perfetto-binary:1.0.0-beta03 e androidx.tracing:tracing-perfetto-handshake:1.0.0-beta03. A versão 1.0.0-beta03 contém estas confirmações.

  • Aumento da versão para corresponder à versão androidx.benchmark.

Versão 1.0.0-beta02

23 de agosto de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-beta02, androidx.tracing:tracing-perfetto-binary:1.0.0-beta02 e androidx.tracing:tracing-perfetto-handshake:1.0.0-beta02. A versão 1.0.0-beta02 contém estas confirmações.

Novos recursos

  • Ativação do suporte para rastreamento na inicialização do app (inicialização a frio).

Versão 1.0.0-beta01

18 de julho de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-beta01, androidx.tracing:tracing-perfetto-binary:1.0.0-beta01 e androidx.tracing:tracing-perfetto-handshake:1.0.0-beta01. A versão 1.0.0-beta01 contém estas confirmações.

Mudanças na API

  • androidx.tracing.perfetto.Trace foi renomeado como androidx.tracing.perfetto.PerfettoSdkTrace (I44af8).
  • O "código de saída" foi renomeado para "código de resultado" no protocolo para manter a consistência (Id1d1e).
  • EnableTracingResponse foi renomeado como Response (I56275).
  • Adição de uma opção para ativar o rastreamento de inicialização a frio em um modo persistente. Adicionamos uma função para limpar o rastreamento de inicialização a frio (persistente ou não). (Iaa09d).
  • As APIs do SDK do Tracing Perfetto foram consistentes com android.os.Trace. (I73ba0, b/282199917).
  • Mudança para um padrão de fábrica para LibrarySource, permitindo que casos de uso futuros (por exemplo, carregar o arquivo .so diretamente) sejam facilmente adicionados à API, se necessário. (I128df).
  • Os parâmetros enableTracingColdStart agora correspondem a enableTracingImmediate (I54126).
  • O argumento killProcess foi removido em enableTracingColdStart (I81c4d).

Versão 1.0.0-alpha17

21 de junho de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha17, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17 e androidx.tracing:tracing-perfetto-handshake:1.0.0-alpha17 sem mudanças desde a versão Alfa anterior. A versão 1.0.0-alpha17 contém estas confirmações.

Versão 1.0.0-alpha16

7 de junho de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha16, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha16 sem mudanças desde a versão Alfa anterior. A versão 1.0.0-alpha16 contém estas confirmações.

Versão 1.0.0-alpha15

3 de maio de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha15, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha15 sem mudanças. A versão 1.0.0-alpha15 contém estas confirmações.

Versão 1.0.0-alpha14

5 de abril de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha14, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha14 sem mudanças. A versão 1.0.0-alpha14 contém estas confirmações.

Versão 1.0.0-alpha13

22 de março de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha13, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha13 sem mudanças desde a última versão. A versão 1.0.0-alpha13 contém estas confirmações.

Versão 1.0.0-alpha12

8 de março de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha12, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha12 sem mudanças desde a versão Alfa anterior. A versão 1.0.0-alpha12 contém estas confirmações.

Versão 1.0.0-alpha11

22 de fevereiro de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha11, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha11 sem mudanças. A versão 1.0.0-alpha11 contém estas confirmações.

Versão 1.0.0-alpha10

8 de fevereiro de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha10, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha10 sem mudanças. A versão 1.0.0-alpha10 contém estas confirmações.

Versão 1.0.0-alpha09

10 de fevereiro de 2023

Lançamento de androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09. A versão 1.0.0-alpha09 contém estas confirmações.

Novos recursos

  • Lançamento de uma versão para permitir que outras bibliotecas androidx.tracing:tracing-perfetto*: 1.0.0-alpha09 funcionem juntas.

11 de janeiro de 2023

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha09 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha09, sem mudanças. A versão 1.0.0-alpha09 contém estas confirmações.

Versão 1.0.0-alpha08

7 de dezembro de 2022

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha08, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha08. A versão 1.0.0-alpha08 contém estas confirmações.

Novos recursos

  • A performance foi aprimorada pela otimização da forma como as strings são processadas.

Correções de bugs

  • Foi adicionada uma regra do ProGuard que impede a remoção de métodos de PerfettoNative se a classe for usada. Isso evita uma falha em um caso específico quando o rastreamento é inicializado, mas não há chamadas de rastreamento no app.

Versão 1.0.0-alpha07

9 de novembro de 2022

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha07, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estas confirmações.

  • A sobrecarga de JNI foi reduzida nas APIs androidx.tracing:tracing-perfetto.

Versão 1.0.0-alpha06

24 de outubro de 2022

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha06, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estas confirmações.

  • Essa atualização não inclui mudanças; ela apenas muda o número da versão para sincronizar com o androidx.benchmark.

Versão 1.0.0-alpha05

5 de outubro de 2022

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha05, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estas confirmações.

Versão 1.0.0-alpha04

21 de setembro de 2022

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha04, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estas confirmações.

Versão 1.0.0-alpha03

7 de setembro de 2022

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha03, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha03.

Novos recursos

  • Nenhum recurso novo desde a versão 1.0.0-alpha02.

Versão 1.0.0-alpha02

24 de agosto de 2022

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha02, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estas confirmações.

Correções de bugs

  • Várias melhorias na inicialização de serviços do Perfetto.
  • Melhoria no tratamento de um caso sem resposta com a introdução de um código de saída dedicado: RESULT_CODE_CANCELLED.
  • Melhoria no processamento de erros de análise.
  • A EnableTracingResponse.requiredVersion agora é anulável, porque não é possível saber a versão se não podemos nos comunicar com o pacote (I5ba20).

Versão 1.0.0-alpha01

27 de julho de 2022

Lançamento de androidx.tracing:tracing-perfetto:1.0.0-alpha01, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

  • Observação: todas as bibliotecas androidx.tracing:tracing-perfetto* são inicialmente destinadas apenas para uso interno nas bibliotecas do AndroidX. Você não precisa depender diretamente delas.

Novos recursos

  • Todas as bibliotecas androidx.tracing:tracing-perfetto* são inicialmente destinadas apenas ao uso dentro das bibliotecas do AndroidX, e você não precisa depender diretamente delas. Estamos documentando esses detalhes de implementação para oferecer transparência.

  • androidx.tracing:tracing-perfetto é uma biblioteca que ajuda a programar eventos de rastros usando o SDK do Perfetto de baixa sobrecarga. Ela pode ser usada na interface do Android Studio, Benchmark ou Perfetto.

  • androidx.tracing:tracing-perfetto-binary é um conjunto de dependências binárias necessárias para o androidx.tracing:tracing-perfetto.

  • androidx.tracing:tracing-perfetto-common é uma dependência interna de androidx.tracing:tracing-perfetto e pode ser usada em ferramentas para fazer a integração com androidx.tracing:tracing-perfetto.

Tracing: versão 1.0.0

Versão 1.0.0

28 de outubro de 2020

Lançamento de androidx.tracing:tracing:1.0.0 e androidx.tracing:tracing-ktx:1.0.0. A versão 1.0.0 contém estas confirmações.

Principais recursos da versão 1.0.0

Ajuda a programar eventos de rastreamento no buffer de rastreamento do sistema. Ela pode ser visualizada com ferramentas como Systrace e Perfetto. Essa biblioteca substitui a classe descontinuada androidx.core.os.TraceCompat.

Versão 1.0.0-rc01

14 de outubro de 2020

Lançamento de androidx.tracing:tracing:1.0.0-rc01 e androidx.tracing:tracing-ktx:1.0.0-rc01. A versão 1.0.0-rc01 contém estas confirmações.

Essa versão é idêntica à 1.0.0-beta01.

Versão 1.0.0-beta01

24 de junho de 2020

Lançamento de androidx.tracing:tracing:1.0.0-beta01 e androidx.tracing:tracing-ktx:1.0.0-beta01, sem mudanças desde a 1.0.0-alpha01. A versão 1.0.0-beta01 contém estas confirmações.

Versão 1.0.0-alpha01

10 de junho de 2020

Lançamento de androidx.tracing:tracing:1.0.0-alpha01 e androidx.tracing:tracing-ktx:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

Novos recursos

androidx.tracing é uma biblioteca que ajuda a programar eventos de rastreamento no buffer de rastreamento do sistema. Ela pode ser visualizada com ferramentas como Systrace e Perfetto. Essa biblioteca substitui a classe descontinuada androidx.core.os.TraceCompat. Essa versão inicial é 1.0.0-alpha01.