Emscripten: An LLVM-to-JavaScript Compiler
Перейти к файлу
Riccardo Magliocchetti 538a4f677c
Give a friendlier error when misusing tools/file_packager.py (#12600)
Catch the case when you are using the very same path as target and
js output.

Fixes #12326
2020-10-29 10:39:10 -07:00
.circleci Split emrun tests out of `browser` (#12594) 2020-10-28 21:06:38 -07:00
.github Remove use of set-env in github actions (#12438) 2020-10-06 12:06:56 -07:00
cmake/Modules Output executables by default. (#11799) 2020-09-14 18:16:26 -07:00
docs [docs] Remove some fastcomp mentions (#12547) 2020-10-20 13:47:01 -07:00
media Improve the main emscripten landing pages (#12091) 2020-09-15 09:50:47 -07:00
site Add some benchmark suite docs (#12625) 2020-10-28 13:00:38 -07:00
src Switch to llvm's PIC ABI for relocatable code (#12461) 2020-10-28 23:08:24 -07:00
system Move emscripten_stack_get_base/end into native code (#12615) 2020-10-28 20:13:45 -07:00
tests Give a friendlier error when misusing tools/file_packager.py (#12600) 2020-10-29 10:39:10 -07:00
third_party Support import(...) in ESTree->Terser conversion (#12365) 2020-09-29 11:15:30 -07:00
tools Give a friendlier error when misusing tools/file_packager.py (#12600) 2020-10-29 10:39:10 -07:00
.clang-format
.editorconfig
.flake8 Add entry points for emdump and file_packager scripts (#12570) 2020-10-21 09:45:45 -07:00
.gitattributes Fix typo in .gitattributes (#11060) 2020-05-01 16:18:49 -07:00
.gitignore Store cache lock inside cache directory (#11614) 2020-07-10 14:55:14 -07:00
.style.yapf
AUTHORS Re-increment uncaught exception count on rethrow (#12535) 2020-10-22 11:32:26 -07:00
CONTRIBUTING.md Link to emscripten.org for contributing info. (#10612) 2020-03-02 13:43:34 -08:00
ChangeLog.md Switch to llvm's PIC ABI for relocatable code (#12461) 2020-10-28 23:08:24 -07:00
LICENSE
Makefile Use DESTDIR instead of uncommon DISTDIR (#11355) 2020-06-05 11:45:12 -07:00
README.md Improve the main emscripten landing pages (#12091) 2020-09-15 09:50:47 -07:00
em++ Require python3 (#11836) 2020-08-07 09:41:49 -07:00
em++.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -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 Require python3 (#11836) 2020-08-07 09:41:49 -07:00
em-config.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
em-config.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
emar Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emar.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
emar.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
embuilder Require python3 (#11836) 2020-08-07 09:41:49 -07:00
embuilder.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
embuilder.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
emcc Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emcc.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
emcc.py Switch to llvm's PIC ABI for relocatable code (#12461) 2020-10-28 23:08:24 -07:00
emcmake Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emcmake.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
emcmake.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
emconfigure Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emconfigure.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
emconfigure.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
emmake Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emmake.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
emmake.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
emranlib Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emranlib.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
emranlib.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
emrun Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emrun.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
emrun.py Split emrun tests out of `browser` (#12594) 2020-10-28 21:06:38 -07:00
emscons Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emscons.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
emscons.py
emscripten-version.txt 2.0.8 (#12597) 2020-10-24 11:32:59 -07:00
emscripten.py Switch to llvm's PIC ABI for relocatable code (#12461) 2020-10-28 23:08:24 -07:00
emsize Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emsize.bat Support spaces in python executable in .bat launcher scripts (#11691) 2020-07-22 22:10:11 -07:00
emsize.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
package-lock.json Update google-closure-compiler (#12345) 2020-09-28 11:23:40 -07:00
package.json Update google-closure-compiler (#12345) 2020-09-28 11:23:40 -07:00
requirements-dev.txt Put python requirements in requirements-dev.txt (#12254) 2020-09-19 18:26:09 -07:00

README.md

emscripten logo

Main project page: http://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.