MDN/Development/Emscripten: Difference between revisions

**The nature of Emscripten compiled JS

* Your first steps with Emscripten

*** Generating the code

*** The asm.js module

This could be a single article but may well be multiple articles under a single section as the document resource grows. The main purpose here is to provide native developers trying to research the feasibility of running their project on the web with some answers.

** non-threading

** async main loop

** async file loading

** memory model

**networking

** performance

* C++ landscape support for Emscripten

** Common C++ libraries/technologies that Emscripten handles successfully (provide links forward to more detailed pages in the techniques section)

** Common C++ libraries/technologies that Emscripten doesn't handle so well

***What needs to be rewritten in C++

***What is better written from scratch on the JavaScript side?

** Other alternatives

** A minimal GL rendering sample that shows how to get stuff up and running?

** Reworking your existing build system to target emscripten

** Co-maintaining both native and emscripten targets simultaneously

** Installable app packaging

** Mobile runtime quirks

===Techniques for working with Emscripten===

** OpenAL

** EGL (see https://github.com/kripken/emscripten/wiki/EGL-Support-in-Emscripten for a good example)

** GLES2

** others...

* Architecting around common problems - provide a case study for each? (Currently we do have some examples of "how do I do X in Emscripten" as part of the unit test suite, but naturally that's not a good format for reading as a documentation/learning material. Some of those could be hoisted or used as a basis for a better set of example apps.)

** non-threading

** async main loop (async compilation is already covered at https://developer.mozilla.org/en-US/docs/Games/Techniques/Async_scripts. Perhaps include some extra explanation about what's going on inside the JS engine?)

** memory model

** networking

** performance

* Emscripten APIs (see https://github.com/kripken/emscripten/blob/master/system/include/emscripten/emscripten.h)

** y

** z

** Developing a JS library to solve problem X

** Gluing it to your Emscripten application

* Benchmarking, profiling and optimization

** optimize web transfers?

* Creating the launch experience

** Creating a start page

* Links to other relevant docs - Graphics, GLES2?

* Links to relevant tool documentation

==Raw ideas==

==What should we talk to?==