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

Camadas de validação

As camadas de validação (validation layers) permitem que os desenvolvedores verifiquem o uso correto da API Vulkan por suas aplicações. As camadas de validação podem ser ativadas tanto em builds de debug quanto de release, incluindo em projetos exportados.

Nota

Ativar as camadas de validação causa um impacto no desempenho, portanto, ative-as apenas quando você realmente precisar da saída para depurar a aplicação.

Windows

Instale o Vulkan SDK https://vulkan.lunarg.com/sdk/home, que contém as camadas de validação como parte de sua instalação padrão. Não há necessidade de ativar nenhum recurso opcional no instalador; instalar o Vulkan SDK principal é o suficiente. Você não precisa reiniciar após instalar o SDK, mas pode precisar fechar e reabrir o terminal atual.

Após instalar o Vulkan SDK, execute o Godot com o argumento de linha de comando --gpu-validation command line argument. Você também pode especificar --gpu-abort, o que fará o Godot fechar assim que ocorrer um erro de validação. Isso pode evitar que o seu sistema congele se ocorrer um erro de validação.

macOS

Aviso

Os builds oficiais do Godot para macOS não suportam camadas de validação, pois estas são vinculadas estaticamente ao Vulkan SDK. Em vez disso, a vinculação dinâmica deve ser usada.

Na prática, isso significa que usar camadas de validação no macOS exige que você use um build do Godot compilado com a opção do SCons use_volk=yes. Compilando para macOS. Se estiver testando camadas de validação em um projeto exportado, você deve recompilar o modelo de exportação e especificá-lo como um modelo de exportação personalizado na predefinição de exportação do macOS do seu projeto.

Instale o Vulkan SDK https://vulkan.lunarg.com/sdk/home, que contém as camadas de validação como parte de sua instalação padrão. Não há necessidade de ativar nenhum recurso opcional no instalador; instalar o Vulkan SDK principal é o suficiente. Você não precisa reiniciar após instalar o SDK, mas pode precisar fechar e reabrir o terminal atual.

Após instalar o Vulkan SDK, execute um binário do Godot que foi compilado com a opção do SCons use_volk=yes. Especifique o argumento de linha de comando --gpu-validation command line argument. Você também pode especificar --gpu-abort, o que fará o Godot fechar assim que ocorrer um erro de validação. Isso pode evitar que o seu sistema congele se ocorrer um erro de validação.

Linux, *BSD

Instale as camadas de validação do Vulkan a partir dos repositórios da sua distribuição:

vulkan-validation-layers

Você não precisa reiniciar após instalar as camadas de validação, mas pode precisar fechar e reabrir o terminal atual.

Após instalar o pacote, execute o Godot com o argumento de linha de comando --gpu-validation command line argument. Você também pode especificar --gpu-abort, o que fará o Godot fechar assim que ocorrer um erro de validação. Isso pode evitar que o seu sistema congele se ocorrer um erro de validação.

iOS

As camadas de validação (validation layers) atualmente não são suportadas no iOS.

Web

As camadas de validação não são suportadas na plataforma web, pois não há suporte para Vulkan nela.

Android

Depois de ativar as camadas de validação no Android, o desenvolvedor poderá ver mensagens de erro e de aviso na saída do adb logcat.

Habilitando camadas de validação

Buildar as camadas de validação a partir das fontes oficiais

Para buildar as bibliotecas do Android, siga as instruções no repositório da Khronos. Após um build bem-sucedido, las bibliotecas estarão localizadas em Vulkan-ValidationLayers/build-android/libs.

Copiar bibliotecas

Copie as bibliotecas de Vulkan-ValidationLayers/build-android/libs para godot/platform/android/java/app/libs/debug/vulkan_validation_layers.

A árvore de diretórios do código-fonte do Godot deve ficar como no exemplo abaixo:

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

Se o subdiretório libs/debug/vulkan_validation_layers não existir, crie-o.

Compilar e executar a aplicação Android

As camadas de validação vinculadas são carregadas e ativadas automaticamente em builds de debug do Android. Você pode usar o recurso de Implantação com um clique do Godot para testar rapidamente seu projeto com as camadas de validação ativadas.