git.s-ol.nu ~forks/DiligentEngine / ext-vk Troubleshooting.md
ext-vk

Tree @ext-vk (Download .tar.gz)

Troubleshooting.md @ext-vkview markup · raw · history · blame

Build fails

  • Make sure your code is up-to-date. When updating existing repository, don't forget to update all submodules:
git pull
git submodule update --recursive
  • Try to get clean version

  • Make sure your build environment is up-to-date and properly configured:

  • When building with Visual Studio, make sure you use Windows SDK 10.0.17763.0 or later, have C++ build tools and Visual C++ ATL Support installed.
  • When building for UWP, make sure you have UWP build tools.
  • When building for Android, make sure all your tools are up to date, you have NDK and CMake installed. If you are not using CMake version bundled with Android Studio, make sure your build files are properly configured.
  • When using gcc, make sure the compiler version is at least 7.4.
  • Make sure you build your project with c++11 features enabled.

  • When including Diligent headers, make sure that exactly one of PLATFORM_WIN32, PLATFORM_UNIVERSAL_WINDOWS, PLATFORM_ANDROID, PLATFORM_LINUX, PLATFORM_MACOS, and PLATFORM_IOS macros is defined as 1.

  • When building on Windows, generating Visual Studio project files is the recommended way. Do not use Visual Studio's built-in CMake and Open Folder option. Other IDEs such as Visual Studio Code or CLion are not guaranteed to work.

  • If on Windows you get long path error, try clonning the project to a folder with shorter name such as c:/git/DiligentEngine.

Projects don't run

  • When running from the command line, make sure that the project's assets folder is set as working directory
  • Try using different backends: use -mode d3d11 or -mode gl command line options