Support & document using custom wasm build (#67)

This commit is contained in:
Olivier Chafik 2024-12-23 01:38:28 +00:00 committed by GitHub
commit c1312c4444
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 36 additions and 10 deletions

View file

@ -8,10 +8,11 @@ SINGLE_BRANCH=--branch master --single-branch
SHALLOW=--depth 1
SHELL:=/usr/bin/env bash
WASM_BUILD=Release
all: public
.PHONY: public
.PHONY: public wasm
public: \
src/wasm \
public/openscad.js \
@ -41,7 +42,7 @@ public: \
clean:
rm -fR libs build
rm -fR public/openscad.{js,wasm}
rm -fR public/libraries
rm -fR public/libraries/*.zip
rm -fR src/wasm
dist/index.js: public
@ -54,13 +55,11 @@ src/wasm: libs/openscad-wasm
rm -f src/wasm
ln -sf "$(shell pwd)/libs/openscad-wasm" src/wasm
# libs/openscad/build/openscad.js: libs/openscad
# ( cd libs/openscad && ./scripts/wasm-base-docker-run.sh emcmake cmake -B build -DCMAKE_BUILD_TYPE=Release -DEXPERIMENTAL=1 )
# ( cd libs/openscad && ./scripts/wasm-base-docker-run.sh /bin/bash -c "cmake --build build -j || cmake --build build -j2 || cmake --build build" )
# libs/openscad-wasm: libs/openscad/build/openscad.js
# mkdir -p libs/openscad-wasm
# cp libs/openscad/build/openscad.* libs/openscad-wasm/
wasm: libs/openscad
( cd libs/openscad && ./scripts/wasm-base-docker-run.sh emcmake cmake -B build -DCMAKE_BUILD_TYPE=$(WASM_BUILD) -DEXPERIMENTAL=1 )
( cd libs/openscad && ./scripts/wasm-base-docker-run.sh /bin/bash -c "cmake --build build -j || cmake --build build -j2 || cmake --build build" )
mkdir -p libs/openscad-wasm
cp libs/openscad/build/openscad.* libs/openscad-wasm/
libs/openscad-wasm:
mkdir -p libs/openscad-wasm
@ -143,7 +142,7 @@ libs/openscad:
public/libraries/openscad.zip: libs/openscad
mkdir -p public/libraries
( cd libs/openscad ; zip -r ../../public/libraries/openscad.zip `find examples -name '*.scad' | grep -v tests` )
( cd libs/openscad ; zip -r - `find examples -name '*.scad' | grep -v tests` ) > public/libraries/openscad.zip
libs/BOSL2:
git clone --recurse https://github.com/BelfrySCAD/BOSL2.git ${SHALLOW} ${SINGLE_BRANCH} $@

View file

@ -85,6 +85,33 @@ rm -fR ../ochafik.github.io/openscad2 && cp -R dist ../ochafik.github.io/opensca
# Now commit and push changes, wait for site update and enjoy!
```
## Build your own WASM binary
[Makefile](./Makefile) fetches a prebuilt OpenSCAD web WASM binary, but you can build your own in a couple of minutes:
- **Optional**: use your own openscad fork / branch:
```bash
rm -fR libs/openscad
ln -s $PWD/../absolute/path/to/your/openscad libs/openscad
# If you had a native build directory, delete it.
rm -fR libs/openscad/build
```
- Build WASM binary (add `WASM_BUILD=Debug` argument if you'd like to debug any cryptic crashes):
```bash
make wasm
```
- Then continue the build:
```bash
make public
npm start
```
## Adding OpenSCAD libraries
You'll need to update 3 files (search for BOSL2 for an example):