Skip to content

Latest commit

 

History

History
107 lines (76 loc) · 4.16 KB

MoltenVK.md

File metadata and controls

107 lines (76 loc) · 4.16 KB
Raw

How to build and use a custom MoltenVK library

There are a lot of hoops to jump through, thanks to lots of Apple security things that result in things like the app just failing to run with Killed: 9 and no further explanation.

$ ./fetchDependencies --macos --spirv-cross-root /Users/oreilly/github/SPIRV-Cross

  • make macos MVK_CONFIG_LOG_LEVEL=1 builds .dylib in: Package/Release/MoltenVK/dylib/macOS/libMoltenVK.dylib -- if you don't specify the log level, you'll get all the info messages.

  • Critically you need to remove the existing file before copying over the new one to /usr/local/lib, where the SDK puts its library:

$ sudo rm /usr/local/lib/libMoltenVK.dylib 
$ sudo cp Package/Release/MoltenVK/dylib/macOS/libMoltenVK.dylib /usr/local/lib

  • If you don't do this, the program will die immediately with Killed: 9 -- all the other unsuccessful stuff below was failed attempts to fix this.

  • Also, there is this mysterious .icd file that needs to refer to the .dylib -- it won't load the library properly if you don't get this one right. The one that is installed by Vulkan SDK is good and the one in the package is NOT -- it specifies a path in the same dir.

The default has a library_path that is relative -- can also have it point to the full correct path:

{
    "file_format_version" : "1.0.0",
    "ICD": {
        "library_path": "/usr/local/lib/libMoltenVK.dylib",
        "api_version" : "1.2.0",
        "is_portability_driver" : true
    }
}

  • Metal library location is: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/metal/macos/lib/clang/31001.667/include/metal

  • Compile a metal file directly to see what is going on:

    • do make in SPIRV-Cross top level, and copy spirv-cross exe to ~/bin
$ spirv-cross gpu_sendspike.spv --metal --msl-version 30000 >ss.metal
$ xcrun -sdk macosx metal ss.metal -std=metal3.0

I've got it working finally -- it took me way too long to figure out that I just needed to disable gatekeeper to not have to reboot every iteration! I tried a bunch of useless stuff about code signing certificates that never worked.

#if MVK_XCODE_14 if ( mvkOSVersionIsAtLeast(12.0) ) { _metalFeatures.mslVersionEnum = MTLLanguageVersion3_0; } #endif

XCode developer certificates, gatekeeper

  • To disable gatekeeper -- didn't help with rebooth issue:
$ sudo /usr/sbin/spctl --master-disable

Here's info on code signing --might be useful someday but definitely didn't help with rebooting.

  • Or sign the thing somehow: https://ioscodesigning.com -- in XCode, can sign in with apple id and get a certificate.
    • Xcode, Preferences, Accounts, + to add
    • enter apple id
    • Do Download Manual Profiles -- doesn't work without this
    • Open Keychain Access app and find certificate, click on Trust and set to Always Trust
    • May need to reboot at this point.

Verify:

$ security find-identity -v -p codesigning

Sign:

$ codesign -f -s rcoreilly@me.com Package/Release/MoltenVK/dylib/macOS/libMoltenVK.dylib
Warning: unable to build chain to self-signed root for signer "Apple Development: rcoreilly@me.com (86223M5MVQ)"
Package/Release/MoltenVK/dylib/macOS/libMoltenVK.dylib: errSecInternalComponent

This seems to fail, as confirmed by:

$ codesign -v Package/Release/MoltenVK/dylib/macOS/libMoltenVK.dylib
Package/Release/MoltenVK/dylib/macOS/libMoltenVK.dylib: code object is not signed at all

and:

$ /usr/sbin/spctl -a -t exec -vv Package/Release/MoltenVK/dylib/macOS/libMoltenVK.dylib

Bunch of stuff that didn't work: https://developer.apple.com/forums/thread/86161

Try installing: https://www.apple.com/certificateauthority/AppleWWDRCAG3.cer