Skip to content

docs: Driver Discovery on macOS is misleading #1870

@crueter

Description

@crueter

The Driver Discovery on macOS section seems to imply that the Vulkan Loader will exclusively look in <app>/Contents/Resources when looking for libraries. However, per LunarG (https://www.lunarg.com/the-state-of-vulkan-on-apple-jan-2026/), the correct layout is to put ICD's in Contents/Resources/vulkan/icd.d, and drivers/the loader in Contents/Frameworks:

YourAmazingVulkan.app
Contents
    Frameworks
        libMoltenVK.dylib
        libvulkan_kosmickrisp.dylib
        libvulkan.1.[version number].dylib
        libvulkan.1.dylib -> (sym link to .dylib above)
    MacOS
        YourAmazingVulkan
    Resources
        vulkan
            icd.d
                MoltenVK_icd.json
                libkosmickrisp_icd.json

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions