Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Perfetto

Ver também

Consulte as instruções do profiler de rastreamento para mais informações.

Perfetto é o sistema de rastreamento padrão para o Android. Na verdade, seu serviço de rastreamento do sistema está integrado à plataforma desde o Android 9.

Usando modelos oficiais do Perfetto

Começando com o Godot 4.7, os modelos de exportação do Perfetto são fornecidos para cada lançamento estável do Godot e podem ser baixados na página de Releases do GitHub.

Usando o modelo de build do Gradle

• Navegue até a página de lançamentos e baixe o artefato de lançamento Godot_v<godot_version>_android_source.perfetto.zip onde godot_version corresponde à versão da engine sendo usada.

• Na caixa de diálogo Projeto > Exportar, as opções Opções Avançadas e Usar Compilador Gradle devem estar habilitadas.

• Aponte o Android Source Template para o modelo de exportação baixado.

Siga as instruções na seção de Configuração para aprender a configurar e criar um rastreamento.

Usando modelos de build sem gradle

• Navegue até a página de lançamentos e baixe os seguintes artefatos de lançamento onde godot_version corresponde à versão da engine sendo usada:

  • Godot_v<godot_version>_android_debug.perfetto.apk (para builds de debug)

  • Godot_v<godot_version>_android_release.perfetto.apk (para builds de release)

• Na janela Projeto > Exportar:

  • Opções Avançadas deve estar habilitado

  • Use Gradle Build deve estar desabilitado

• Aponte o Custom Template para os modelos de exportação baixados.

Siga as instruções na seção de Configuração para aprender a configurar e criar um rastreamento.

Builds customizados do Godot com suporte ao Perfetto

A partir do diretório raiz do godot, execute o seguinte script python para instalar a versão mais recente do Perfetto SDK sob thirdparty/perfetto:

python misc/scripts/install_perfetto.py

Em seguida, builde os modelos de debug ou release do Android para a sua arquitetura usando o scons (conforme Compiling for Android), mas adicionando o argumento profiler=perfetto.

Nota

Geralmente é recomendado fazer o profiling de modelos de release, porque essa é a versão que seus jogadores usarão, e ela se comportará de maneira diferente de outros tipos de builds. No entanto, no caso do Android, às vezes pode ser útil usar modelos de debug, porque o Godot só consegue fazer a depuração remota de jogos exportados a partir de modelos de debug.

Por exemplo, para compilar os modelos de release para arm64:

scons platform=android target=template_release arch=arm64 generate_android_binaries=yes profiler=perfetto

Configuração

O Perfetto requer um arquivo de configuração para dizer a ele quais eventos rastrear.

Crie um arquivo chamado godot.config com este conteúdo:

# Trace for 10 seconds.
duration_ms: 10000

buffers {
    size_kb: 32768
    fill_policy: RING_BUFFER
}

# Write to file once every second to prevent overflowing the buffer.
write_into_file: true
file_write_period_ms: 1000

# Track events in the "godot" category.
data_sources {
    config {
        name: "track_event"
        track_event_config {
            enabled_categories: "godot"
        }
    }
}

Nota

O Godot registra duas categorias de eventos de rastreamento:

• godot: Usado para registrar eventos da engine Godot. É usado para análise de desempenho. A sobrecarga de rastreamento de eventos não deve impactar significativamente o desempenho. Este deve ser o modo de rastreamento típico para a maioria dos desenvolvedores.

• godot_scripting: Usado para registrar eventos de script do Godot. Esta é uma categoria lenta, pois analisa toda a lógica de script do jogo. É usada para compreensão de código / depuração / encontrar o que causou um engasgo (hitch) de quadro. O desempenho é muito mais lento, mas ajuda a encontrar aquela chamada de função problemática que de outra forma estaria oculta.

Gravar um trace

Por fim, inicie seu jogo em um dispositivo Android usando os modelos de exportação que você buildou anteriormente.

Quando você estiver pronto para gravar um rastreamento (por exemplo, quando tiver atingido a parte do jogo que apresenta problemas de desempenho), você pode usar este script do repositório GitHub do Perfetto.

./record_android_trace -c /path/to/godot.config

Isso gravará por 10 segundos (conforme a configuração) ou até que você pressione Ctrl + C.

Examinando o trace

Assim que o script terminar, ele abrirá a interface do Perfetto em um navegador web.

Para ver os eventos do Godot, expanda a linha do seu aplicativo clicando no seu Nome Exclusivo / Nome do Pacote / ID do App do Android (o Perfetto também incluirá alguns eventos dos serviços do sistema no rastreamento).

Então você pode usar as teclas WASD para navegar no gráfico:

• Pressione A ou D para navegar para frente ou para trás ao longo da linha do tempo

• Pressione W ou S para aproximar ou afastar o zoom

Você provavelmente precisará dar um pouco de zoom antes de conseguir ver os eventos individuais do Godot.

Para saber mais, consulte a documentação da UI do Perfetto.