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

Шари перевірки

Рівні перевірки дозволяють розробникам перевірити правильність використання Vulkan API їх програмою. Рівні перевірки можна ввімкнути як у збірках налагодження, так і в збірках випуску, зокрема в експортованих проектах.

Примітка

Увімкнення рівнів перевірки впливає на продуктивність, тому вмикайте їх лише тоді, коли вам дійсно потрібен результат для налагодження програми.

Windows

Установіть Vulkan SDK https://vulkan.lunarg.com/sdk/home, який містить рівні перевірки як частину інсталяції за замовчуванням. Немає необхідності вмикати будь-які додаткові функції в інсталяторі; достатньо встановити базовий Vulkan SDK. Вам не потрібно перезавантажуватись після встановлення SDK, але вам може знадобитися закрити та знову відкрити поточний термінал.

Після встановлення Vulkan SDK запустіть Godot із --gpu-validation command line argument. Ви також можете вказати --gpu-abort, який змусить Godot завершити роботу, щойно станеться помилка перевірки. Це може запобігти зависанню вашої системи, якщо станеться помилка підтвердження.

macOS

Попередження

Офіційні збірки Godot macOS не підтримують рівні перевірки, оскільки вони статично пов’язані з Vulkan SDK. Натомість слід використовувати динамічне зв’язування.

На практиці це означає, що використання рівнів перевірки в macOS вимагає від вас використання збірки Godot, скомпільованої з параметром SCons use_volk=yes. Компіляція для macOS. Якщо ви перевіряєте перевірочні шари в експортованому проекті, ви повинні перекомпілювати шаблон експорту та вказати його як спеціальний шаблон експорту в попередньому налаштуванні експорту macOS вашого проекту.

Установіть Vulkan SDK https://vulkan.lunarg.com/sdk/home, який містить рівні перевірки як частину інсталяції за замовчуванням. Немає необхідності вмикати будь-які додаткові функції в інсталяторі; достатньо встановити базовий Vulkan SDK. Вам не потрібно перезавантажуватись після встановлення SDK, але вам може знадобитися закрити та знову відкрити поточний термінал.

Після встановлення Vulkan SDK запустіть двійковий файл Godot, скомпільований із параметром SCons use_volk=yes. Укажіть --gpu-validation command line argument. Ви також можете вказати --gpu-abort, який змусить Godot завершити роботу, щойно станеться помилка перевірки. Це може запобігти зависанню вашої системи, якщо станеться помилка перевірки.

Лінукс, *BSD

Установіть шари перевірки Vulkan зі сховищ вашого дистрибутива:

vulkan-validation-layers

Вам не потрібно перезавантажуватись після встановлення шарів перевірки, але вам може знадобитися закрити та знову відкрити поточний термінал.

Після встановлення пакета запустіть Godot із --gpu-validation command line argument. Ви також можете вказати --gpu-abort, який змусить Godot завершити роботу, щойно станеться помилка перевірки. Це може запобігти зависанню вашої системи, якщо станеться помилка перевірки.

iOS

Шари валідації наразі не підтримуються на iOS.

Інтернет

Шари перевірки не підтримуються на веб-платформі, оскільки там немає підтримки Vulkan.

Android

Після ввімкнення рівнів перевірки на Android розробник може бачити помилки та попередження у виводі adb logcat.

Увімкнення шарів перевірки

Створюйте рівні перевірки з офіційних джерел

Щоб створити бібліотеки Android, дотримуйтесь інструкцій у репозиторії Khronos'. Після успішного збирання бібліотеки будуть розташовані в Vulkan-ValidationLayers/build-android/libs.

Бібліотеки копій

Скопіюйте бібліотеки з Vulkan-ValidationLayers/build-android/libs до godot/platform/android/java/app/libs/debug/vulkan_validation_layers.

Дерево каталогів вашого вихідного коду Godot має виглядати, як у прикладі нижче:

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

Якщо підкаталог libs/debug/vulkan_validation_layers не існує, створіть його.

Скомпілюйте та запустіть програму Android

Зв’язані рівні перевірки автоматично завантажуються та вмикаються в збірках налагодження Android. Ви можете скористатися функцією Godot Розміщення в один клік, щоб швидко перевірити свій проект із увімкненими шарами перевірки.