No emscripten port provides raylib — emcc --show-ports offers contrib.glfw3
and nothing else nearby — so build-web.sh clones raylib at the 5.5 tag and
compiles its seven modules with -DPLATFORM_WEB -DGRAPHICS_API_OPENGL_ES2 into
one archive under vendor/raylib/web, which is gitignored along with the
checkout it came from.
5.5 because that is the tag whose .so.550 the host links. raylib.flan carries
raylib's struct layouts and enum values, and two targets built from different
raylibs would disagree about them without saying so.
rglfw.c is not among the modules: the web platform uses emscripten's own GLFW
port, which is why link carries @web -sUSE_GLFW=3. No headers are installed,
for the same reason the host build needs none — the generated shim declares
the prototypes it uses.
link now names the host library under @native and the archive under @web,
through ${FLAN_RAYLIB_WEB}, so a web build with the variable unset is refused
with the name of the variable rather than a page of undefined GLFW symbols.
The one thing this costs: a wasi build that reaches raylib now fails on
undefined symbols instead of on the missing -l:libraylib.so.550.
32 lines
1.5 KiB
Plaintext
32 lines
1.5 KiB
Plaintext
# Extra linker arguments for this package, one per line. A line may be
|
|
# addressed to one target — @native, @wasi, @web — and an untagged line
|
|
# applies to all of them. ${NAME} expands from the environment. The selection
|
|
# and the expansion happen in Build, which is the only place that knows which
|
|
# target is being built; Load reads these lines and passes them through.
|
|
|
|
# The host. Fedora's package installs the versioned soname and no unversioned
|
|
# symlink, so -lraylib finds nothing and the file has to be named.
|
|
@native -l:libraylib.so.550
|
|
@native -lm
|
|
|
|
# The browser. No shared library exists for wasm, so this is a static archive
|
|
# built out of raylib's own sources by vendor/raylib/build-web.sh, pinned to
|
|
# the 5.5 tag that matches the host's .so.550 — raylib.flan carries raylib's
|
|
# struct layouts and enum values, and two targets built from different raylibs
|
|
# would disagree about them without saying so.
|
|
#
|
|
# FLAN_RAYLIB_WEB is where that archive is. Unset, a web build that reaches
|
|
# raylib is refused by name here rather than met as a page of undefined GLFW
|
|
# symbols; build-web.sh prints the line to export.
|
|
@web ${FLAN_RAYLIB_WEB}
|
|
|
|
# raylib's web platform is GLFW on emscripten's own port, not the rglfw.c it
|
|
# compiles in natively, and WebGL is GLES2. GL_ENABLE_GET_PROC_ADDRESS because
|
|
# rlgl asks for extension pointers by name.
|
|
@web -sUSE_GLFW=3
|
|
@web -sGL_ENABLE_GET_PROC_ADDRESS
|
|
|
|
# -sASYNCIFY is not here: Build adds it to every web link, because the reason
|
|
# for it is the browser's event loop and not raylib. See Build's comment on the
|
|
# main loop.
|