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

Validation layers

I livelli di validazione permettono agli sviluppatori di verificare il corretto utilizzo dell'API Vulkan dalle loro applicazioni. È possibile abilitare i livelli di validazione nelle build sia di debug sia di rilascio, inclusi i progetti esportati.

Nota

L'abilitazione dei livelli di validazione ha un impatto sulle prestazioni, quindi abilitarli solo quando è effettivamente necessario l'output per il debug dell'applicazione.

Windows

Installare l'SDK Vulkan https://vulkan.lunarg.com/sdk/home, che include i livelli di validazione come parte dell'installazione predefinita. Non è necessario abilitare alcuna funzionalità opzionale durante l'installazione; basta installare l'SDK Vulkan base. Non è necessario riavviare il sistema dopo l'installazione dell'SDK, ma potrebbe essere necessario chiudere e riaprire il terminale attualmente in uso.

Dopo aver installato l'SDK Vulkan, eseguire Godot con l'argomento della riga di comando --gpu-validation. È possibile anche specificare --gpu-abort che farà chiudere Godot non appena avviene un errore di validazione, il che può impedire al sistema di bloccarsi in tal caso.

macOS

Avvertimento

Le build ufficiali di Godot per macOS non supportano i livelli di validazione, poiché questi sono collegati staticamente all'SDK Vulkan. È necessario utilizzare il collegamento dinamico.

In pratica, ciò significa che l'utilizzo dei livelli di validazione su macOS richiede l'utilizzo di una build di Godot compilata con l'opzione SCons use_volk=yes. Compilare per macOS. Se si testano i livelli di validazione su un progetto esportato, è necessario ricompilare il modello di esportazione e specificarlo come modello di esportazione personalizzato nella preimpostazione di esportazione per macOS del progetto.

Installare l'SDK Vulkan https://vulkan.lunarg.com/sdk/home, che include i livelli di validazione come parte dell'installazione predefinita. Non è necessario abilitare alcuna funzionalità opzionale durante l'installazione; basta installare l'SDK Vulkan base. Non è necessario riavviare il sistema dopo l'installazione dell'SDK, ma potrebbe essere necessario chiudere e riaprire il terminale attualmente in uso.

Dopo aver installato l'SDK Vulkan, eseguire un binario di Godot compilato con l'opzione SCons use_volk=yes. Specificare l'argomento della riga di comando --gpu-validation. È possibile anche specificare --gpu-abort che farà chiudere Godot non appena avviene un errore di validazione, il che può impedire al sistema di bloccarsi in tal caso.

Linux, *BSD

Installare i livelli di validazione Vulkan dai repository della propria distribuzione:

vulkan-validation-layers

Non è necessario riavviare il sistema dopo aver installato i livelli di convalida, ma potrebbe essere necessario chiudere e riaprire il terminale attualmente in uso.

Dopo aver installato il pacchetto, eseguire Godot con l'argomento della riga di comando --gpu-validation. È possibile anche specificare --gpu-abort che farà chiudere Godot non appena avviene un errore di validazione, il che può impedire al sistema di bloccarsi in tal caso.

iOS

I livelli di validazione non sono attualmente supportati su iOS.

Web

I livelli di validazione non sono supportati sulla piattaforma web, poiché non è presente il supporto per Vulkan.

Android

Dopo aver abilitato i livelli di validazione su Android, uno sviluppatore può visualizzare errori e messaggi di avviso nell'output di adb logcat.

Abilitare livelli di validazione

Compilare livelli di validazione da sorgenti ufficiali

Per compilare le librerie Android, seguire le istruzioni presenti nel repository Khronos. Dopo una compilazione riuscita, le librerie si troveranno nella cartella Vulkan-ValidationLayers/build-android/libs.

Copiare le librerie

Copia le librerie da Vulkan-ValidationLayers/build-android/libs a godot/platform/android/java/app/libs/debug/vulkan_validation_layers.

L'albero delle cartella sorgente di Godot dovrebbe apparire come nell'esempio seguente:

godot
|-- platform
    |-- android
        |-- java
            |-- app
                |-- libs
                    |-- debug
                        |-- vulkan_validation_layers
                            |-- arm64-v8a
                            |-- armeabi-v7a
                            |-- x86
                            |-- x86_64

Se la sottocartella libs/debug/vulkan_validation_layers non esiste, crearla.

Compilare ed eseguire l'app Android

I livelli di validazione collegati vengono caricati e abilitati automaticamente nelle build di debug per Android. È possibile utilizzare la funzionalità Distribuzione con un clic in Godot per testare rapidamente il progetto con i livelli di validazione abilitati.