Emscripten: An LLVM-to-JavaScript Compiler
Перейти к файлу
Sam Clegg 729ed9b75f
Warning if MAXIUMUM_MEMORY used without ALLOW_MEMORT_GROWTH. NFC (#14816)
Previously we were silently ignoring it.  We considered the alternative
which would be to automatically enable ALLOW_MEMORT_GROWTH but decided
that would be more of a breaking/surprise change.
2021-08-06 11:33:10 -07:00
.circleci Finish roll of LLVM 14 version change (#14780) 2021-07-28 17:03:20 -07:00
.github Switch primary git branch from `master` to `main` (#13624) 2021-03-08 15:51:21 -08:00
cmake/Modules cmake: Default to installing into sysroot (#14293) 2021-05-27 18:58:03 +02:00
docs [Docs] More docs on building the docs: pip and requirements-dev.txt (#14483) 2021-06-22 14:31:10 -07:00
media Remove artifacts from Emscripten_logo_full, added single logo svg/png (#13790) 2021-03-30 16:08:55 -07:00
site Added timestamp to EmscriptenTouchEvent (#14752) 2021-08-06 10:48:06 +03:00
src Re-raise pthread exceptions back on the main thread (#13666) 2021-08-06 10:27:54 -07:00
system Added timestamp to EmscriptenTouchEvent (#14752) 2021-08-06 10:48:06 +03:00
tests Warning if MAXIUMUM_MEMORY used without ALLOW_MEMORT_GROWTH. NFC (#14816) 2021-08-06 11:33:10 -07:00
third_party Assume Buffer.from/alloc exist under node (#14447) 2021-06-15 12:01:14 -07:00
tools Fix EMCC_FORCE_STDLIBS and re-enable tests for it (#11712) 2021-08-05 13:10:53 -07:00
.clang-format Add .clang-format file (copied from binaryen) (#7164) 2018-09-21 11:12:41 -07:00
.coveragerc Bring emcoverage tool back to life. NFC (#13598) 2021-03-04 10:48:02 -08:00
.editorconfig Add .editorconfig (#8359) 2019-03-28 09:52:16 -07:00
.eslintrc.yml Add eslint for linting our build-time JS code (#13305) 2021-01-26 12:58:39 -08:00
.flake8 Fix flake8 warnings in webidl_binder.py. NFC (#13823) 2021-04-06 12:03:49 -07:00
.gitattributes Fix typo in .gitattributes (#11060) 2020-05-01 16:18:49 -07:00
.gitignore Bring emcoverage tool back to life. NFC (#13598) 2021-03-04 10:48:02 -08:00
.gitmodules Update posixtestsuite submodule (#13013) 2020-12-11 13:24:29 -08:00
.style.yapf Add .style.yapf for the YAPF python formatter (#6782) 2018-06-29 17:25:55 -07:00
AUTHORS Added timestamp to EmscriptenTouchEvent (#14752) 2021-08-06 10:48:06 +03:00
CONTRIBUTING.md Link to emscripten.org for contributing info. (#10612) 2020-03-02 13:43:34 -08:00
ChangeLog.md Re-raise pthread exceptions back on the main thread (#13666) 2021-08-06 10:27:54 -07:00
LICENSE mention third_party in LICENSE 2016-04-13 11:06:10 -07:00
Makefile Run npm install as part of the install (#12899) 2020-12-05 08:17:25 -08:00
README.md Switch primary git branch from `master` to `main` (#13624) 2021-03-08 15:51:21 -08:00
em++ Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
em++.bat Fix .bat launcher to allow special characters (#14260) 2021-05-21 21:54:51 -07:00
em++.py Add option to not default for C++ (which matches clang/gcc behaviour) (#10879) 2020-04-10 19:49:48 -07:00
em-config Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
em-config.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
em-config.py Split config file handling out of shared.py. NFC. (#12699) 2020-11-09 08:06:33 -08:00
emar Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emar.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emar.py Create wrappers for llvm-dwp and llvm-nm (#14659) 2021-07-16 17:44:40 -07:00
embuilder Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
embuilder.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
embuilder.py Include all ports as embuilder tasks (#14737) 2021-07-23 12:27:10 -07:00
emcc Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emcc.bat Fix .bat launcher to allow special characters (#14260) 2021-05-21 21:54:51 -07:00
emcc.py Warning if MAXIUMUM_MEMORY used without ALLOW_MEMORT_GROWTH. NFC (#14816) 2021-08-06 11:33:10 -07:00
emcmake Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emcmake.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emcmake.py emcmake: Don't use get_building_env when running cmake (#14411) 2021-06-08 16:01:39 -07:00
emconfigure Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emconfigure.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emconfigure.py Move cmake/configure/make code out of shared.py and into the scripts themselves. NFC. (#13772) 2021-03-25 23:38:25 +01:00
emdump Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emdump.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emdwp Create wrappers for llvm-dwp and llvm-nm (#14659) 2021-07-16 17:44:40 -07:00
emdwp.bat Create wrappers for llvm-dwp and llvm-nm (#14659) 2021-07-16 17:44:40 -07:00
emmake Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emmake.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emmake.py Fix windows-only typo in emmake.py (#13813) 2021-04-05 16:26:28 -07:00
emnm Create wrappers for llvm-dwp and llvm-nm (#14659) 2021-07-16 17:44:40 -07:00
emnm.bat Create wrappers for llvm-dwp and llvm-nm (#14659) 2021-07-16 17:44:40 -07:00
emprofile Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emprofile.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emranlib Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emranlib.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emranlib.py Fix remaining #! lines that were not using python3 (#14325) 2021-05-30 12:06:58 -07:00
emrun Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emrun.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emrun.py Explicitly close file descriptors in python code. NFC (#14074) 2021-06-15 17:05:21 -07:00
emscons Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emscons.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emscons.py Switch the #! lines in all .py files to python3 (#10357) 2020-02-05 15:27:36 -08:00
emscripten-version.txt Mark 2.0.26 as released (#14759) 2021-07-26 16:39:44 -07:00
emscripten.py Error if there is no main() when using PROXY_TO_PTHREAD (#14476) 2021-06-21 15:49:39 -07:00
emsize Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emsize.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emsize.py Update emsize after roll (#14633) 2021-07-12 11:55:59 -07:00
package-lock.json Update pinned npm deps. NFC (#14580) 2021-07-02 10:34:44 -07:00
package.json Update pinned npm deps. NFC (#14580) 2021-07-02 10:34:44 -07:00
requirements-dev.txt Require sphinx-build 2.4.4 to build site (#14224) 2021-05-21 08:17:38 -07:00

README.md

emscripten logo

Main project page: https://emscripten.org

GitHub CI status: CircleCI

Chromium builder status: emscripten-releases

Overview

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 and asmjs-unknown-emscripten targets).

License

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.