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
pacman -S vulkan-validation-layers
apt install vulkan-validationlayers
dnf install vulkan-validation-layers
pkg install graphics/vulkan-validation-layers
emerge -an media-libs/vulkan-layers
urpmi vulkan-validation-layers
pkg_add graphics/vulkan-validation-layers
zypper install vulkan-validationlayers
eopkg install -c 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.