Update emsdk version from 763c2d21 to cef24b4f (#27502) This is an automatic change generated by tools/maint/rebaseline_tests.py --update-emsdk. emsdk version updated: 763c2d21 => cef24b4f The following revisions were included in this update: ``` - cef24b4f Roll llvm-project from 83959f01d350 to 2f9775ad49bf (33 revisions) - 75605f3c Roll emscripten from ec43f619371c to 2f3d9cc68dde (1 revision) - d4e9387f Roll emscripten from 4946c02c3801 to ec43f619371c (1 revision) - 970da17d Roll emscripten from 8be44a7966ad to 4946c02c3801 (2 revisions) - 84286965 Roll llvm-project from b3a4504bd99b to 83959f01d350 (106 revisions) - c36617da Roll v8 from 45a68e7aa0d4 to eebbc36f6f06 (35 revisions) - 6d9c248b Roll binaryen from b97310a2f0c5 to f1b0e46c248c (4 revisions) - 2613781d Roll llvm-project from 34323ab08e6e to b3a4504bd99b (31 revisions) ``` Full log: https://chromium.googlesource.com/emscripten-releases/+log/763c2d21..cef24b4f The following (21) test expectation files were updated by running the tests with `--rebaseline`: ``` codesize/test_codesize_cxx_ctors1.json: 153927 => 153937 [+10 bytes / +0.01%] codesize/test_codesize_cxx_ctors2.json: 153333 => 153343 [+10 bytes / +0.01%] codesize/test_codesize_cxx_except.json: 200099 => 200109 [+10 bytes / +0.00%] codesize/test_codesize_cxx_except_wasm.json: 169465 => 169475 [+10 bytes / +0.01%] codesize/test_codesize_cxx_except_wasm_legacy.json: 167325 => 167335 [+10 bytes / +0.01%] codesize/test_codesize_cxx_lto.json: 119542 => 119548 [+6 bytes / +0.01%] codesize/test_codesize_cxx_mangle.json: 266429 => 266439 [+10 bytes / +0.00%] codesize/test_codesize_cxx_noexcept.json: 155837 => 155847 [+10 bytes / +0.01%] codesize/test_codesize_cxx_wasmfs.json: 180955 => 180965 [+10 bytes / +0.01%] codesize/test_codesize_files_wasmfs.json: 63232 => 63240 [+8 bytes / +0.01%] codesize/test_codesize_hello_dylink.json: 44105 => 44113 [+8 bytes / +0.02%] codesize/test_codesize_hello_dylink_all.json: 856207 => 856215 [+8 bytes / +0.00%] codesize/test_codesize_mem_O3.json: 9135 => 9143 [+8 bytes / +0.09%] codesize/test_codesize_mem_O3_grow.json: 9470 => 9478 [+8 bytes / +0.08%] codesize/test_codesize_mem_O3_grow_standalone.json: 9298 => 9306 [+8 bytes / +0.09%] codesize/test_codesize_mem_O3_standalone.json: 9132 => 9140 [+8 bytes / +0.09%] codesize/test_codesize_mem_O3_standalone_lib.json: 8325 => 8333 [+8 bytes / +0.10%] codesize/test_codesize_mem_O3_standalone_narg.json: 8447 => 8455 [+8 bytes / +0.09%] codesize/test_codesize_mem_O3_standalone_narg_flto.json: 7378 => 7386 [+8 bytes / +0.11%] codesize/test_codesize_minimal_pthreads.json: 25964 => 25975 [+11 bytes / +0.04%] codesize/test_codesize_minimal_pthreads_memgrowth.json: 26416 => 26427 [+11 bytes / +0.04%] Average change: +0.04% (+0.00% - +0.11%) ``` Co-authored-by: emscripten-bot <emscripten-bot@users.noreply.github.com>
Main project page: https://emscripten.org
Chromium builder status: emscripten-releases
Emscripten compiles C and C++ to WebAssembly using LLVM and Binaryen. Emscripten output can run on the Web, in Node.js, and in wasm runtimes.
Emscripten provides Web support for popular portable APIs such as OpenGL and SDL2, allowing complex graphical native applications to be ported, such as the Unity game engine and Google Earth. It can probably port your codebase, too!
While Emscripten mostly focuses on compiling C and C++ using Clang, it can be integrated with other LLVM-using compilers (for example, Rust has Emscripten integration, with the wasm32-unknown-emscripten target).
For detailed instructions and tutorials, visit the Emscripten Website.
There are two primary ways to install Emscripten:
Using the Emscripten SDK (emsdk) (Recommended) The easiest way to get started is by using the Emscripten SDK. Follow the instructions on the downloads page to install it.
From a Git Checkout (Manual Installation) If you have cloned the repository from Git, you can install the dependencies manually and then run the bootstrap script:
./bootstrap.py
For more details, see the developer guide.
Run emcc like you would gcc or clang:
$ emcc hello.c -o hello.js $ node hello.js Hello, world!
Emscripten will compile your code into a WebAssembly module along with a JavaScript file that can load and run it. You can then run the resulting JavaScript in your browser or under Node.js (or Deno or Bun).
Emscripten can also generate a sample HTML page that then loads the JavaScript:
$ emcc hello.c -o hello.html
You can then serve the generated hello.html using the emrun tool, or a web server of your choosing.
For information on how to contribute to the project, see CONTRIBUTING.md and the Contributing section on the website.
Emscripten is available under 2 licenses, the MIT license and the University of Illinois/NCSA Open Source License.
Both are permissive open source licenses, with little if any practical difference between them.
The reason for offering both is that (1) the MIT license is well-known and suitable for a compiler toolchain, while (2) LLVM‘s original license, the University of Illinois/NCSA Open Source License, was also offered to allow Emscripten’s code to be integrated upstream into LLVM. The second reason became less important after Emscripten switched to the LLVM wasm backend, at which point there isn't any code we expect to move back and forth between the projects; also, LLVM relicensed to Apache 2.0 + exceptions meanwhile. In practice you can just consider Emscripten as MIT licensed (which allows you to do pretty much anything you want with a compiler, including commercial and non-commercial use).
See LICENSE for the full content of the licenses.