Skip to content

Latest commit

 

History

History
49 lines (33 loc) · 1.31 KB

build_setup.md

File metadata and controls

49 lines (33 loc) · 1.31 KB

Build setup

To build retrowin32 you need the Rust toolchain.

If running graphical programs locally, you will need SDL (see below for setup).

If you are building the web-based retrowin32, see the web/ docs.

If you're making Windows API changes or see build errors about missing clang-cl, you need the Clang toolchain. See win32/README.md.

If you are building the various helper test programs or see build errors about a missing kernel32.lib, you need the Windows SDK (see below for setup).

SDL

Mac:

$ brew install sdl2
$ export LIBRARY_PATH="$LIBRARY_PATH:$(brew --prefix)/lib"

(If targeting Rosetta you need an x86 SDL, see x86-64 docs.)

Debian/Ubuntu:

$ sudo apt install libsdl2-dev

Windows SDK, aka XWIN

The retrowin32 tree includes test programs that produce win32 exe files. To build these you need some Windows headers. The xwin tool automates downloading these.

To install it, follow their instructions. Then run it like:

$ xwin --accept-license --arch x86 splat
# also pass --disable-symlinks if on a case insensitive filesystem, like Mac

This will unpack the files into ~/.xwin-cache/splat.