Emscripten: An LLVM-to-JavaScript Compiler
Перейти к файлу
Sam Clegg cbc974264e
JS style: consistent use of space around for/while/if conditions. NFC. (#13669)
2021-03-16 16:09:43 +01:00
.circleci Remove `make` dependency from hardbuzz port (#13655) 2021-03-14 09:37:12 -07:00
.github Switch primary git branch from `master` to `main` (#13624) 2021-03-08 15:51:21 -08:00
cmake/Modules Update Emscripten.cmake to support C++20 (#13616) 2021-03-07 12:37:56 -08:00
docs Switch primary git branch from `master` to `main` (#13624) 2021-03-08 15:51:21 -08:00
media Improve the main emscripten landing pages (#12091) 2020-09-15 09:50:47 -07:00
site Cleanup use of possibly offensive language (#13634) 2021-03-10 10:19:02 -08:00
src JS style: consistent use of space around for/while/if conditions. NFC. (#13669) 2021-03-16 16:09:43 +01:00
system Avoid compiling stb_image at link time (#13658) 2021-03-15 17:34:36 -07:00
tests tests: use @node_pthreads decorator in test_other.py (#13667) 2021-03-15 22:21:30 -07:00
third_party Avoid compiling stb_image at link time (#13658) 2021-03-15 17:34:36 -07:00
tools Possibly use a response file for llvm-nm. Fixes #13661 (#13664) 2021-03-16 11:40:37 +02:00
.clang-format
.coveragerc Bring emcoverage tool back to life. NFC (#13598) 2021-03-04 10:48:02 -08:00
.editorconfig
.eslintrc.yml Add eslint for linting our build-time JS code (#13305) 2021-01-26 12:58:39 -08:00
.flake8 Make tools/create_dom_pk_codes.py idempotent (#12683) 2020-11-02 15:31:25 -08: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
AUTHORS Big Endian Support (using extra acorn AST pass) (#13413) 2021-03-09 13:57:15 -08:00
CONTRIBUTING.md Link to emscripten.org for contributing info. (#10612) 2020-03-02 13:43:34 -08:00
ChangeLog.md Report error if EM_ASM or EM_JS used in side modules (#13649) 2021-03-12 12:33:30 -08:00
LICENSE
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++ Require python3 (#11836) 2020-08-07 09:41:49 -07:00
em++.bat Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02: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 Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02:00
em-config.py Split config file handling out of shared.py. NFC. (#12699) 2020-11-09 08:06:33 -08:00
emar Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emar.bat Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02: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 Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02:00
embuilder.py Fix `embuilder --force` for ports (#13611) 2021-03-06 09:25:36 +01:00
emcc Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emcc.bat Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02:00
emcc.py Avoid compiling stb_image at link time (#13658) 2021-03-15 17:34:36 -07:00
emcmake Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emcmake.bat Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02: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 Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02: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 Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02: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 Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02: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 Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02:00
emrun.py Fix crash in emrun.py (#13553) 2021-02-24 12:34:33 -08:00
emscons Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emscons.bat Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02:00
emscons.py Switch the #! lines in all .py files to python3 (#10357) 2020-02-05 15:27:36 -08:00
emscripten-version.txt 2.0.15 (#13613) 2021-03-05 23:46:36 -08:00
emscripten.py Fix SIDE_MODULE + STACK_OVERFLOW_CHECK (#13538) 2021-03-15 15:24:09 -07:00
emsize Require python3 (#11836) 2020-08-07 09:41:49 -07:00
emsize.bat Fix Windows .bat files to not leak echo state and environment variables to calling bat files/environment. (#12784) 2020-11-15 21:43:04 +02:00
emsize.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
package-lock.json Add eslint for linting our build-time JS code (#13305) 2021-01-26 12:58:39 -08:00
package.json Add eslint for linting our build-time JS code (#13305) 2021-01-26 12:58:39 -08:00
requirements-dev.txt Bring emcoverage tool back to life. NFC (#13598) 2021-03-04 10:48:02 -08: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.