Skip to content

Latest commit

 

History

History
34 lines (24 loc) · 1.18 KB

Emscripten.md

File metadata and controls

34 lines (24 loc) · 1.18 KB
Raw

Building & Running For Web (Emscripten)

Building in Emscripten - asm.js/WebAssembly - works on Linux and WSL.

You will need to install the emscripten compiler. See https://emscripten.org/docs/getting_started/downloads.html for complete instructions, but generally you should just browse to your desired directory and:

git clone https://github.com/emscripten-core/emsdk.git
cd emsdk
./emsdk install latest
./emsdk activate latest
source ./emsdk_env.sh

You should now have commands like emcc in your path, and an EMSDK environment variable set ready to build your project.

In your project directory create a new build directory, enter it and configure your project:

mkdir build.em
cd build.em
emcmake cmake .. -D32BLIT_DIR="/path/to/32blit/repo"

⚠️ Make sure to include the -D32BLIT_DIR="/path/to/32blit/repo" parameter to the cmake command (even when building the SDK examples). You must specify an absolute path here when building with Emscripten.

Once CMake has finished configuring your project you can build it:

make
python3 -m http.server

Finally, open the URL given by Python's HTTP server in your browser and open your project's .html file.