Building the samples

Supported platforms are: Windows, macOS, Linux (with X11) and web

On Linux install the following packages: libglu1-mesa-dev, mesa-common-dev, xorg-dev, libasound-dev (or generally: the dev packages required for X11, GL and ALSA development)

sokol.h: You can use it add headers

// sokol.h
#include "sokol_app.h"
#include "sokol_gfx.h"
 ... and more
#include "nuklear.h"

Add headers dictionary and build c files in build.zig

var user_h_dirs = .{
    "new_dir/lib",
};
var user_c_files = .{
    "new_dir/lib/nuklear.c",
};

To build the platform-native samples:

# First generite glsl to h shaders file if use glsl
zig build shaders
# or build example shaders
zig build shaders -Dexample

# build and run project:
zig build
zig build run

# build and run example:
zig build -Dexample
zig build -Dexample clear
zig build -Dexample triangle
zig build -Dexample quad
 ...

(also run zig build --help to inspect the build targets)

By default, the backend 3D API will be selected based on the target platform:

macOS: Metal
Windows: D3D11
Linux: GL

To force the GL backend on macOS or Windows, build with -Dgl=true:

> zig build -Dgl=true -Dexample clear

The clear sample prints the selected backend to the terminal:

sokol-zig ➤ zig build -Dgl=true -Dexample clear
Backend: .sokol.gfx.Backend.GLCORE33

For the web-samples, run:

zig build -Dtarget=wasm32-emscripten
# or to build and run one of the samples
zig build clear -Dexample -Dtarget=wasm32-emscripten
...

When building with target wasm32-emscripten for the first time, the build script will install and activate the Emscripten SDK into the Zig package cache for the latest SDK version. There is currently no build system functionality to update or delete the Emscripten SDK after this first install. The current workaround is to delete the global Zig cache (run zig env to see where the Zig cache resides).

Improving the Emscripten SDK integration with the Zig build system is planned for the future.

emsdk

sokolc