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...

Tracy

Vedi anche

Consultare le istruzioni per il profiler di tracciamento per ulteriori informazioni.

Tracy è un profiler open source che funziona su un'ampia varietà di piattaforme, tra cui Windows, Linux e macOS. Sebbene sia principalmente un profiler di tracciamento, può anche campionare periodicamente i dati come un profiler di campionamento, offrendo alcuni dei vantaggi di entrambi gli approcci.

Compilare Godot con supporto per Tracy

Innanzitutto, clona l'ultima versione del codice sorgente di Tracy ("0.13.0" al momento in cui scriviamo) attraverso Git:

git clone -b v0.13.0 --single-branch https://github.com/wolfpld/tracy.git

Questo creerà una cartella tracy - puoi collocarla ovunque.

Successivamente, crea i modelli di rilascio per la piattaforma interessata tramite scons, ma aggiungendo gli argomenti profiler=tracy profiler_path=path/to/tracy con il percorso reale della cartella tracy, nonché debug_symbols=yes per consentire alle funzionalità di campionamento di Tracy di funzionare.

Nota

Non è obbligatorio creare modelli di rilascio; si potrebbero creare anche modelli di debug o persino l'editor. Tuttavia, in genere si consiglia di profilare i modelli di rilascio, perché è la versione che i giocatori useranno e le sue prestazioni saranno diverse rispetto ad altri tipi di build.

Ad esempio, per creare modelli di rilascio per Windows:

scons platform=windows target=template_release debug_symbols=yes profiler=tracy profiler_path=path/to/tracy

Ottieni il "server" di Tracy

Nella terminologia di Tracy, l'applicazione che si sta profilando è il "client", mentre quella che riceve i dati è il "server".

Se utilizzi Windows, puoi scaricare una versione precompilata di tracy-profiler.exe dalla pagina dei rilasci di Tracy.

Tuttavia, se utilizzi Linux o macOS, dovrai trovare un binario precompilato tramite un gestore di pacchetti (come brew o nix) oppure compilarlo personalmente da sorgente.

Nota

Se utilizzi un eseguibile precompilato, assicurati di usare la stessa versione usata per compilare Godot.

Compila il server di Tracy da sorgente

Per compilare Tracy, è necessario installare cmake, che può essere scaricato dal sito web di CMake oppure installato tramite un gestore di pacchetti (come brew o nix).

Le istruzioni complete per compilare Tracy da sorgente si trovano nel manuale di Tracy, ma ecco un breve riassunto:

# On Linux, Tracy uses Wayland by default, so if you use X11 add -DLEGACY=1
cmake -B profiler/build -S profiler -DCMAKE_BUILD_TYPE=Release
cmake --build profiler/build --config Release --parallel

Questo posizionerà il file binario in tracy/profiler/build/tracy-profiler o tracy/profiler/build/tracy-profiler.exe (su Windows).

Registrare una traccia

Avvia il server Tracy - dovresti vedere qualcosa di simile a questo:

../../../_images/cpp_profiler_tracy_start.webp

Premi "connect". Facendo così Tracy si connetterà immediatamente all'avvio del gioco. Se ti dimentichi di premere "connect", Tracy memorizzerà gli eventi di sistema nella RAM, il che può rapidamente aumentare l'utilizzo della memoria (consultare la documentazione di TRACY_ON_DEMAND).

Ora, esporta il gioco utilizzando i modelli di rilascio creati prima e avvialo. Non appena entrambi saranno in esecuzione e avrai premuto il pulsante "Connect" in Tracy, vedrai arrivare i dati:

../../../_images/cpp_profiler_tracy_recording.webp

Quando pensi di aver raccolto abbastanza dati, premi il pulsante "Stop". Se hai cliccato da qualche parte e la casella con il pulsante "Stop" è scomparsa, puoi cliccare sull'icona in alto a sinistra per farla ricomparire.

Esaminare la traccia

Ecco alcuni controlli di base:

  • Ingrandisci/riduci con la rotellina del mouse

  • Fai clic destro e trascina per spostarti avanti/indietro sulla timeline

  • Nella barra superiore, clicca sui pulsanti freccia sinistra e destra accanto a "Frames" per spostare un singolo fotogramma sulla timeline

Per saperne di più, consulta il manuale di Tracy.