Emscripten: An LLVM-to-JavaScript Compiler
Перейти к файлу
Sam Clegg e6f4d49566
Remove use of addAtMain is webidl_binder.py (#14585)
Support for `addAtMain` in application without a main function was
removed in #13901 but I missed that fact that webidl_binder.py was doing
this.

This change replaces `addAtMain` with `addOnInit` and also makes the use
of `addAtMain` in applications without a `main` into an error so that
the problem (and solution) should be clear.

Update webidl binder test to only use sync compilation when needed, so
that code in question actually gets tested.

This change also reduces code size by not including `addAtMain` at all
in applications without a `main`.

Fixes: #14583.
2021-07-13 09:50:49 -07:00
.circleci Make alignMemory into a library function (#14560) 2021-06-30 23:47:36 +02: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 [Docs] Fix typo in tutorial example, we need to require() the right file. (#14584) 2021-07-02 16:58:12 -07:00
src Remove use of addAtMain is webidl_binder.py (#14585) 2021-07-13 09:50:49 -07:00
system Assert on proper alignment in dlmalloc (#14634) 2021-07-12 13:39:40 -07:00
tests Remove use of addAtMain is webidl_binder.py (#14585) 2021-07-13 09:50:49 -07:00
third_party Assume Buffer.from/alloc exist under node (#14447) 2021-06-15 12:01:14 -07:00
tools Remove use of addAtMain is webidl_binder.py (#14585) 2021-07-13 09:50:49 -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 File packager: base64_encode embedded data files (#14526) 2021-06-25 09:10:52 -07:00
CONTRIBUTING.md Link to emscripten.org for contributing info. (#10612) 2020-03-02 13:43:34 -08:00
ChangeLog.md Improve changelog (#14620) 2021-07-09 19:01:16 -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 Reinstate --cache flag in its original form (#14039) 2021-04-28 13:57:30 -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 Rename libgl.a -> libGL.a (#14351) 2021-06-06 22:23:56 -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 Fix the handling of shared library dependencies in subfolders. (#14193) 2021-07-13 16:13:29 +01: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
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
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.25 as released (#14564) 2021-06-30 10:52:39 -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.