linux: add Vulkan build and runtime support #32

Closed

utmostmick0 wants to merge 7 commits from linux-vulkan-port into main

utmostmick0 commented

2026-11-07 05:10:50 +00:00

(Migrated from github.com)

Summary

Add the Linux HOS compatibility layer based on the Linux port used by SkyboundTotk.
Add Linux Vulkan loading and X11/Wayland surface support, producing hookshot_vk.so.
Add Linux/system SDK discovery and a resumable end-to-end build script at scripts/build-linux.sh.
Keep WebGPU optional; Linux can build and run through Vulkan without wgpu-native.

Usage

./scripts/build-linux.sh --exefs /path/to/exefs --jobs 1
HOOKSHOT_ROMFS=/path/to/romfs work/sa/build/run-hookshot.sh

Validation

Linux Vulkan backend build completed successfully and produced an ELF shared object.
Host C and Vulkan C++ syntax checks passed.
Python scripts, shell script syntax, and Git whitespace checks passed.
Full lifted game image generation/build was started separately; generated game artifacts are not included in this PR.

## Summary - Add the Linux HOS compatibility layer based on the Linux port used by SkyboundTotk. - Add Linux Vulkan loading and X11/Wayland surface support, producing `hookshot_vk.so`. - Add Linux/system SDK discovery and a resumable end-to-end build script at `scripts/build-linux.sh`. - Keep WebGPU optional; Linux can build and run through Vulkan without wgpu-native. ## Usage ```sh ./scripts/build-linux.sh --exefs /path/to/exefs --jobs 1 HOOKSHOT_ROMFS=/path/to/romfs work/sa/build/run-hookshot.sh ``` ## Validation - Linux Vulkan backend build completed successfully and produced an ELF shared object. - Host C and Vulkan C++ syntax checks passed. - Python scripts, shell script syntax, and Git whitespace checks passed. - Full lifted game image generation/build was started separately; generated game artifacts are not included in this PR.

👍 2 🎉 3

vitor3canova-cyber commented

2026-11-07 05:44:00 +00:00

(Migrated from github.com)

keep getting .py error, maybe wrong dump?

utmostmick0 commented

2026-11-07 05:45:40 +00:00

(Migrated from github.com)

keep getting .py error, maybe wrong dump?

Got a log ?

> keep getting .py error, maybe wrong dump? Got a log ?

NotRexed commented

2026-11-07 23:07:47 +00:00

(Migrated from github.com)

Thanks a lot for this, it got Linux going. Linux support has since landed on main (Vulkan build, AppImage with every release) through the smaller PRs, so this one no longer applies. Closing; if anything here is still missing on main, a fresh small PR against main is very welcome.

utmostmick0 commented

2026-11-07 23:55:57 +00:00

(Migrated from github.com)