0 Fork 0

Files

T

西风逍遥游 6a12870e17 fix(macosx): load MoltenVK and build the instance through SDL's loader

Two defects made packaged macOS games fail at window creation:

1. The bundled MoltenVK_icd.json used a relative library_path; the Khronos
   loader resolves it with dlopen() against the process cwd / system dirs,
   never the manifest directory, so MoltenVK was silently ignored and the
   surface extensions were missing. bootstrapBundledVulkan() now rewrites the
   manifest with the absolute dylib path before setting VK_ICD_FILENAMES.

2. vk-bootstrap dlopens its own libvulkan (vulkan.hpp DynamicLoader, which
   even throws 'Failed to load vulkan library!' on machines without a system
   Vulkan), so the VkInstance was created by a DIFFERENT loader than the one
   SDL cached; SDL_Vulkan_CreateSurface then could not resolve the surface
   functions. createInstanceAndDevice now seeds the Vulkan-Hpp default
   dispatcher from SDL_Vulkan_GetVkGetInstanceProcAddr() and marks
   vkb::InstanceBuilder loaded, so the instance is built through the same
   bundled loader SDL uses.

2026-08-23 13:44:43 +08:00

CMakeLists.txt

feat: add macOS support and improve platform handling

2026-08-05 21:40:41 +08:00

macosx.h

fix(macos): bundle Vulkan loader + MoltenVK in the SDK so players do not need the LunarG SDK

2026-08-21 12:30:47 +08:00

macosx.mm

fix(macosx): load MoltenVK and build the instance through SDL's loader

2026-08-23 13:44:43 +08:00

README.md

fix(macos): bundle Vulkan loader + MoltenVK in the SDK so players do not need the LunarG SDK

2026-08-21 12:30:47 +08:00

README.md

macosx target SDK notes

This directory is the packaging template shipped inside dist/eve-sdk/macosx[-debug].

Publish a macOS game by shipping:

bin/eve from the SDK
lib/ from the SDK — this now contains the bundled Vulkan loader (libvulkan.1.dylib), MoltenVK (libMoltenVK.dylib) and its ICD manifest (MoltenVK_icd.json); see cmake/macosx_bundle_vulkan.cmake
Your game folder (config.nut, main.nut, assets)
Optional native plugins (.dylib) loaded via eve.Plugins().load(...)

The SDK install renames eve's loader reference to @rpath/libvulkan.1.dylib and gives eve the @loader_path/../lib rpath, so the whole tree is self-contained: the player does not need the LunarG Vulkan SDK or any Vulkan environment variables. At startup eve points SDL and the Vulkan loader at the bundled files (eve::macosx::bootstrapBundledVulkan in platform/macosx/macosx.mm). The player machine only needs a Metal-capable macOS (the engine requires macOS 12+).

For an .app bundle, copy the same three Vulkan files into Contents/Frameworks/ (the bootstrap also checks ../Frameworks next to the executable) and set Contents/MacOS/eve's rpath to @executable_path/../Frameworks.