macOS: Install instructions should include need to add /usr/local/lib to the library search paths. #1001
Labels
build
This is relevant to the build system
documentation
Improvements or additions to documentation
Mac
On macOS, the Vulkan SDK installer deposits the Vulkan and MoltenVK
dylib
files in/usr/local/lib
. In order to run Vulkan Samples, this path needs to be included in the library search pathsvulkan_samples
runs under. Without this, Volk fails to initialize.macOS does not include
/usr/local/lib
in the library search paths by default. It can be included a couple of different ways, including either of the following:Include
/usr/local/lib
in theLD_RUNPATH_SEARCH_PATHS
build setting when buildingvulkan_samples
on macOS. Although I am not acmake
expert, I assume this could probably be done by updating the build config files.Invoke
export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH
prior to launchingvulkan_samples
from the command line. Since this can be done by the user, this might just need some documentation in either the Usage or Build/macOS sections of the Vulkan Samples documentation.Also, on a related note, the Build/macOS instructions includes a requirement:
I suggest this could probably be reworded to just "Installed Vulkan SDK", and removing the reference to
./install_vulkan.py
. These days, Vulkan Installer App takes care of installing thedylibs
automatically for most Vulkan SDK installations, and the referenced Vulkan SDK Getting Started guide already covers the details of both the installer app and./install_vulkan.py
, if a user wants to install from the command line instead of using the installer app.The text was updated successfully, but these errors were encountered: