Skip to content

Latest commit

 

History

History
96 lines (65 loc) · 3.59 KB

BUILD.md

File metadata and controls

96 lines (65 loc) · 3.59 KB
Raw

PopTracker build instructions

We only use make at the moment. Feel free to create your own project/build setup, see Why no XYZ?!.

make native builds a native binary
make cross cross-compiles a windows binary on *nix
make wasm builds a wasm blob, this may be broken and does not fully work yet

Unless we decide to include source to build all dependencies, they'll have to be installed system-wide or copied to win32-lib/lib. Static libs depend on your toolchain, so they are not included.

  • Lua is built from a submodule
  • Header-only libraries are included
  • For other dependencies:
    • Linux: use your package manager
    • Windows: use MSYS2
    • MacOS: use brew

See individual build instructions below for dependencies.

Getting the source

Run git clone --recurse-submodules https://github.com/black-sliver/PopTracker.git or download the latest "full-source.tar.xz" from Releases.

Arch Linux

Native

  • pacman -S base-devel sdl2 sdl2_image sdl2_ttf openssl # install dependencies
  • run make native CONF=RELEASE to generate ./build/<platform>/poptracker binary

Cross Compile

  • pacman -S mingw-w64-gcc # install cross compile toolchain
  • install mingw-w64-{sdl2,sdl2_image,sdl2_ttf,openssl} from AUR # install dependencies
  • run make cross CONF=RELEASE

WASM

  • pacman -S emscripten # install emscripten
  • if /usr/lib/emscripten/node_modules is missing or empty, you need to fix that
    • latest arch package includes node_modules, so update should fix it
  • run make wasm CONF=RELEASE

Ubuntu / Debian

Native

  • sudo apt install build-essential libsdl2-dev libsdl2-image-dev libsdl2-ttf-dev libssl-dev # install dependencies
  • run make native CONF=RELEASE to generate ./build/<platform>/poptracker binary

Windows

GCC / MSYS2

  • install MSYS2 from https://www.msys2.org/

  • install dependencies:

    pacman -S base-devel coreutils make mingw-w64-x86_64-toolchain mingw64/mingw-w64-x86_64-SDL2 \
mingw64/mingw-w64-x86_64-SDL2_image mingw64/mingw-w64-x86_64-SDL2_ttf mingw64/mingw-w64-x86_64-freetype \
mingw64/mingw-w64-x86_64-openssl p7zip

    or see github workflow

  • run make CONF=RELEASE

If the windows build is failing, MSYS probably changed libraries. Create an issue on github.

The build found in Releases is done with a customized sdl2, so the builds differ from MSYS ones.

MacOS

  • run brew install coreutils SDL2 sdl2_ttf sdl2_image [email protected]
  • run make CONF=RELEASE

The build will link against brew libraries.

If you run make CONF=DIST, this will build non-brew versions of the libraries and replace the references in the resulting app bundle.
Dependencies to build the bundle: run brew install automake libtool autoconf

Why not XYZ?!

The release builds for Windows and macos are very custom since we do not want to force msys or brew on anyone and use a gnu toolchain for development.

  • Meson's submodules system would be great, but some of them are very outdated or incomplete and maintinaing the recipes for all dependencies is too much work.
  • CMake did fail when trying to create the static windows build, at which point we'd need to modify and maintain CMake files for subprojects.
  • Autotools could probably be used to strip down the Makefile, feel free to provide an example.
  • An additional VS solution could be maintained by someone, feel free to fork, PR and document.
  • An additional XCode project could be maintained by someone, feel free to fork, PR and document.