Retrace do R8

O retrace do R8 é uma ferramenta para receber o stack trace original de um ofuscado. O stack trace é reconstruído, combinando nomes de classes e de métodos em um arquivo de mapeamento para as definições originais deles.

Observação: o retrace do R8 é uma ferramenta autônoma na versão 4.0 do pacote de ferramentas de linha de comando, lançada com o Android Studio 4.2.

Para fazer o download do pacote de ferramentas de linha de comando com o SDK Manager, consulte Atualizar ferramentas com o SDK Manager. O SDK Manager instala o retrace do R8 em cmdline-tools/version/bin/.

Para fazer o download do pacote de ferramentas de linha de comando usando a linha de comando, consulte sdkmanager.

Uso

Para fazer o retrace de um stack trace ofuscado, transmita o arquivo de mapeamento para retrace:

retrace  path-to-mapping-file [path-to-stack-trace-file] [options] 

Se nenhum arquivo de stack trace for fornecido na linha de comando, o retrace do R8 vai aguardar que ele seja inserido pelo usuário na entrada padrão. Depois da entrada, encerre o stream de entrada:

• Linux e macOS: Ctrl + D
• Windows: Control+Z+Enter

A saída do novo rastreamento é gravada na saída padrão.

Opções

A tabela descreve as opções de linha de comando do retrace do R8:

Opção	Obrigatório?	Descrição
--verbose	não	Mostra mais informações, por exemplo, parâmetros e tipo de retorno do método.
--info	não	Define o nível de diagnóstico como info. Para uma análise mais detalhada, consulte DiagnosticsHandler.
--quiet	não	Reduz a quantidade de informações mostradas para aumentar o foco.
--regex <regular_exp>	não	Substitui a expressão regular padrão para analisar linhas de stack trace. Por exemplo, veja a seguir um regex que pode analisar stack traces básicos: (?:.*? at %c\.%m\(%s(?::%l)?\))|(?:(?:.*?[:"] +)?%c(?::.*)?).

Notas de uso

O retrace do R8 usa o arquivo de mapeamento gerado para mapear nomes de classes e métodos ofuscados de volta para a definição original. Para saber mais sobre a redução do seu app para que ele possa receber um retrace corretamente, consulte Decodificar um stack trace ofuscado.