A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

ActiveTrace

public class ActiveTrace
extends Object

java.lang.Object
↳	com.android.tradefed.invoker.tracing.ActiveTrace

Classe principal que ajuda a descrever e gerenciar um rastreamento ativo.

Resumo

Constantes
`String`	`TRACE_KEY`

Construtores públicos
`ActiveTrace(long pid, long tid)`
`ActiveTrace(long pid, long tid, boolean mainProcess)` Construtor.

Métodos públicos
`void`	`addSubprocessTrace(File subTrace)` Forneça o arquivo de rastreamento de um subprocesso a ser adicionado ao pai.
`File`	`finalizeTracing()` Informa os arquivos de rastreamento finais e limpa os recursos conforme necessário.
`boolean`	`isMainTradefedProcess()`
`void`	`reportTraceEvent(String categories, String name, PerfettoTrace.TrackEvent.Type type)`
`void`	`reportTraceEvent(String categories, String name, int threadId, String threadName, PerfettoTrace.TrackEvent.Type type)` Relatórios de eventos muito básicos para fazer INÍCIO / FIM de rastreamentos.
`long`	`reportingThreadId()` ID da linha de execução que iniciou o rastreamento.
`void`	`startTracing(boolean isSubprocess)` Inicie o rastreamento e informe os metadados dele.

Constantes

TRACE_KEY

public static final String TRACE_KEY

Valor da constante: "invocation-trace"

Construtores públicos

ActiveTrace

public ActiveTrace (long pid, 
                long tid)

Parâmetros
`pid`	`long`
`tid`	`long`

ActiveTrace

public ActiveTrace (long pid, 
                long tid, 
                boolean mainProcess)

Construtor.

Parâmetros
`pid`	`long`: ID do processo atual
`tid`	`long`: ID da linha de execução atual
`mainProcess`	`boolean`

Métodos públicos

addSubprocessTrace

public void addSubprocessTrace (File subTrace)

Forneça o arquivo de rastreamento de um subprocesso a ser adicionado ao pai.

Parâmetros
`subTrace`	`File`

finalizeTracing

public File finalizeTracing ()

Informa os arquivos de rastreamento finais e limpa os recursos conforme necessário.

Retorna
`File`

isMainTradefedProcess

public boolean isMainTradefedProcess ()

Retorna
`boolean`

reportTraceEvent

public void reportTraceEvent (String categories, 
                String name, 
                PerfettoTrace.TrackEvent.Type type)

Parâmetros
`categories`	`String`
`name`	`String`
`type`	`PerfettoTrace.TrackEvent.Type`

reportTraceEvent

public void reportTraceEvent (String categories, 
                String name, 
                int threadId, 
                String threadName, 
                PerfettoTrace.TrackEvent.Type type)

Relatórios de eventos muito básicos para fazer INÍCIO / FIM de rastreamentos.

Parâmetros
`categories`	`String`: categoria associada ao evento
`name`	`String`: nome do evento
`threadId`	`int`
`threadName`	`String`
`type`	`PerfettoTrace.TrackEvent.Type`: tipo do evento que está sendo informado.

reportingThreadId

public long reportingThreadId ()

ID da linha de execução que iniciou o rastreamento.

Retorna
`long`

startTracing

public void startTracing (boolean isSubprocess)

Inicie o rastreamento e informe os metadados dele.

Parâmetros
`isSubprocess`	`boolean`