Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Validation Layers

Validation Layers ermöglichen es Entwicklern, die korrekte Verwendung der Vulkan-API durch ihre Anwendung zu überprüfen. Validation Layers können sowohl in Debug- als auch in Release-Builds aktiviert werden, auch in exportierten Projekten.

Bemerkung

Die Aktivierung von Validation Layers wirkt sich auf die Performance aus. Aktivieren Sie sie daher nur, wenn Sie die Ausgabe tatsächlich zum Debuggen der Anwendung benötigen.

Windows

Installieren Sie das Vulkan SDK https://vulkan.lunarg.com/sdk/home, das als Teil seiner Standardinstallation Validation Layers enthält. Sie brauchen keine optionalen Features im Installationsprogramm zu aktivieren; die Installation des Vulkan-SDK-Kerns reicht aus. Sie müssen nach der Installation des SDKs nicht neu booten, aber Sie müssen möglicherweise Ihr aktuelles Terminal schließen und wieder öffnen.

Nachdem Sie das Vulkan SDK installiert haben, starten Sie Godot mit dem --gpu-validation Kommandozeilenargument. Sie können auch --gpu-abort angeben, was Godot beenden wird, sobald ein Validierungsfehler auftritt. Dies kann verhindern, dass Ihr System einfriert, wenn ein Validierungsfehler auftritt.

macOS

Warnung

Offizielle Godot macOS-Builds unterstützen keine Validation Layers, da diese statisch mit dem Vulkan-SDK verknüpft sind. Stattdessen muss dynamisches Linking verwendet werden.

In der Praxis bedeutet dies, dass es für die Verwendung von Validation Layers unter macOS erforderlich ist, dass Sie einen Godot-Build verwenden, der mit der SCons-Option use_volk=yes kompiliert wurde. Kompilieren für MacOS. Wenn Sie Validation Layers auf einem exportierten Projekt testen, müssen Sie die Exportvorlage neu kompilieren und sie als benutzerdefinierte Exportvorlage in der macOS-Exportvorgabe Ihres Projekts angeben.

Installieren Sie das Vulkan SDK https://vulkan.lunarg.com/sdk/home, das als Teil seiner Standardinstallation Validation Layers enthält. Sie brauchen keine optionalen Features im Installationsprogramm zu aktivieren; die Installation des Vulkan-SDK-Kerns reicht aus. Sie müssen nach der Installation des SDKs nicht neu booten, aber Sie müssen möglicherweise Ihr aktuelles Terminal schließen und wieder öffnen.

Nach der Installation des Vulkan-SDK führen Sie ein Godot-Binary aus, das mit der SCons-Option use_volk=yes kompiliert wurde. Geben Sie das --gpu-validation Kommandozeilenargument an. Sie können auch --gpu-abort angeben, was Godot beenden wird, sobald ein Validierungsfehler auftritt. Dies kann verhindern, dass Ihr System einfriert, wenn ein Validierungsfehler auftritt.

Linux, *BSD

Installieren Sie Vulkan-Validation Layers aus den Repositorys Ihrer Distribution:

vulkan-validation-layers

Nach der Installation der Validation Layers müssen Sie nicht neu starten, aber möglicherweise müssen Sie Ihr aktuelles Terminal schließen und neu öffnen.

Nachdem Sie das Paket installiert haben, starten Sie Godot mit dem --gpu-validation Kommandozeilenargument. Sie können auch --gpu-abort angeben, wodurch Godot beendet wird, sobald ein Validierungsfehler auftritt. Dies kann verhindern, dass Ihr System einfriert, wenn ein Validierungsfehler auftritt.

Android

Nach der Aktivierung von Validation Layers unter Android können Fehler und Warnmeldungen in der Entwickler-Ausgabe adb logcat auftauchen.

iOS

Validation Layers werden unter iOS derzeit nicht unterstützt.

Web

Validation Layers werden auf der Webplattform nicht unterstützt, da es dort keine Unterstützung für Vulkan gibt.

Aktivieren von Validation Layers

Erstellen von Validation Layers aus offiziellen Quellen

Um die Android-Bibliotheken zu erstellen, folgen Sie den Anweisungen im Khronos'-Repository. Nach einem erfolgreichen Build befinden sich die Bibliotheken in Vulkan-ValidationLayers/build-android/libs.

Bibliotheken kopieren

Kopieren Sie die Bibliotheken von Vulkan-ValidationLayers/build-android/libs nach godot/platform/android/java/app/libs/debug/vulkan_validation_layers.

Ihr Godot-Stammverzeichnisbaum sollte wie im folgenden Beispiel aussehen:

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

Wenn das Unterverzeichnis libs/debug/vulkan_validation_layers nicht existiert, erstellen Sie es.

Kompilieren und Ausführen der Android-Anwendung

Gelinkte Validation Layers werden in Android-Debug-Builds automatisch geladen und aktiviert. Sie können Godots Ein-Klick-Auslieferung-Feature verwenden, um Ihr Projekt mit aktivierten Validation Layers schnell zu testen.