Skip to content

Commit aad0143

Browse files
Remove build_mpos_web.sh
1 parent a5c6951 commit aad0143

1 file changed

Lines changed: 5 additions & 6 deletions

File tree

docs/web-port/developer.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This section describes how MicroPythonOS runs in the browser, how to build and s
99
# The build auto-activates ../emsdk or ../../emsdk if emcc is not on PATH.
1010

1111
# 2. Build the web target.
12-
scripts/build_mpos_web.sh
12+
scripts/build_mpos.sh web
1313

1414
# 3. Build (if needed) and serve locally at http://localhost:8080/
1515
scripts/run_web.sh
@@ -21,7 +21,7 @@ Output artifacts land in `web/`: `micropython.{html,js,wasm,data}`, plus copies
2121

2222
## Prerequisites
2323

24-
- **Emscripten SDK** (tested with **6.0.0**). Either have `emcc` on `PATH`, or place an activated `emsdk` checkout one or two directories above this repo (`../emsdk` or `../../emsdk`). `scripts/build_mpos_web.sh` sources `emsdk_env.sh` automatically when `emcc` is missing.
24+
- **Emscripten SDK** (tested with **6.0.0**). Either have `emcc` on `PATH`, or place an activated `emsdk` checkout one or two directories above this repo (`../emsdk` or `../../emsdk`). `scripts/build_mpos.sh web` sources `emsdk_env.sh` automatically when `emcc` is missing.
2525
- Standard host toolchain to build `mpy-cross` (built with the host compiler, not emcc) and the usual MicroPython build dependencies (`python3`, `make`).
2626
- The git submodules must be checked out (`git submodule update --init --recursive`). A **clean** submodule checkout is fine — the build re-applies the web changes every time.
2727

@@ -40,7 +40,7 @@ cd MicroPythonOS
4040
# (emcc on PATH, or an activated emsdk at ../emsdk or ../../emsdk).
4141

4242
# 3. Build and serve.
43-
scripts/build_mpos_web.sh
43+
scripts/build_mpos.sh web
4444
scripts/run_web.sh
4545
```
4646

@@ -89,7 +89,6 @@ Key design points:
8989
| Path | Purpose |
9090
| --- | --- |
9191
| [`scripts/build_mpos.sh`](https://github.com/MicroPythonOS/MicroPythonOS/blob/main/scripts/build_mpos.sh) | Central build orchestration. The `web` target branch does all web-specific work (patching the submodule, staging the FS, injecting shims, invoking `make.py web`, collecting artifacts). |
92-
| [`scripts/build_mpos_web.sh`](https://github.com/MicroPythonOS/MicroPythonOS/blob/main/scripts/build_mpos_web.sh) | Convenience wrapper: activates emsdk then runs `build_mpos.sh web`. |
9392
| [`scripts/run_web.sh`](https://github.com/MicroPythonOS/MicroPythonOS/blob/main/scripts/run_web.sh) | Build (optional) + serve `web/` with `python3 -m http.server`. |
9493
| [`scripts/web_port/web.py`](https://github.com/MicroPythonOS/MicroPythonOS/blob/main/scripts/web_port/web.py) | The Emscripten build backend. Copied into `lvgl_micropython/builder/web.py` at build time; consumed by `make.py web`. |
9594
| [`scripts/web_port/sdl_bus.h.patch`](https://github.com/MicroPythonOS/MicroPythonOS/blob/main/scripts/web_port/sdl_bus.h.patch) | C struct-layout fix applied to the `lcd_bus` SDL bus (see "Submodule patches"). |
@@ -134,7 +133,7 @@ To verify reproducibility, revert the submodule files and rebuild — the build
134133
&& rm -f builder/web.py ext_mod/lcd_bus/sdl_bus/sdl_bus.h.rej \
135134
&& rm -rf ext_mod/_webnet )
136135
( cd lvgl_micropython/lib/micropython && git checkout -- ports/unix/gccollect.c )
137-
scripts/build_mpos_web.sh
136+
scripts/build_mpos.sh web
138137
```
139138

140139
The two C patches were verified to apply cleanly (`patch --forward`, exit 0, no `.rej`) against the pinned commits listed in *Build from a fresh clone*.
@@ -213,7 +212,7 @@ Notes / limitations:
213212

214213
## Making changes — common scenarios
215214

216-
- **Change MPOS Python code / apps:** edit under `internal_filesystem/` as usual, then rebuild (`scripts/build_mpos_web.sh`). The staged FS is rebuilt every time, so changes are picked up. (Most of the FS is baked into `micropython.data` at link time; a rebuild is required — there is no live file mount. `/data` and `/apps` are the exception: they persist in IndexedDB across reloads — see "Persistence".)
215+
- **Change MPOS Python code / apps:** edit under `internal_filesystem/` as usual, then rebuild (`scripts/build_mpos.sh web`). The staged FS is rebuilt every time, so changes are picked up. (Most of the FS is baked into `micropython.data` at link time; a rebuild is required — there is no live file mount. `/data` and `/apps` are the exception: they persist in IndexedDB across reloads — see "Persistence".)
217216
- **Change the HTML/JS shell:** edit `web/shell.html`, rebuild. `index.html` and `mpos.html` are regenerated from it.
218217
- **Change build/link flags:** edit `scripts/web_port/web.py`, rebuild.
219218
- **Change a patched submodule C file:** see "Updating a submodule patch".

0 commit comments

Comments
 (0)