#summary One-sentence summary of this page.

This page is a brief introduction of how to get emscripten to work.

= Introduction =

This guide is not targeted to hedgewars currently but meant to help you set up the environment to get emscripten working.

= Set Up emscripten =

You can follow the steps here to set up emscripten: https://github.com/kripken/emscripten/wiki/Tutorial

Be sure to set up the correct path in ~/.emscripten. The default paths are mostly not suitable for you.

= Potential problems =

= How to get llvm and clang 3.0 =

If you cannot checkout through svn for some network issues, you can find git mirrors in github here (which should work for everyone):

https://github.com/llvm-mirror/llvm (checkout release_30 branch)

https://github.com/llvm-mirror/clang (checkout release_30 branch)

https://github.com/llvm-mirror/compiler-rt (checkout release_30 branch)

Follow the official guide to build from source code (http://llvm.org/docs/GettingStarted.html).

= Some tests =

There are a lot of tests in the tests folder. You can refer to (https://github.com/kripken/emscripten/wiki/Tutorial) for more details.

Here I just give some simple examples.

(Assume that you are in the emscripten root directory, where you can see the 'emcc' file)

./emcc tests/hello_world.cpp

node a.out.js

You should be able to see "hello world!" in the terminal

If you want to have it run in browsers, you can type this (as in official tutorial):

./emcc tests/hello_world_sdl.cpp -o hello.html

./emcc tests/hello_world_gles.c -o hello_world_gles.html

llvm 3.1+ won't compile this demo. The reason is that this demo uses malloc which has to been compiled first from dlmalloc. However emscripten uses llvm-ld as the linker, which has been removed in llvm 3.1+, and the result is that you will encounter some strange error messages saying that "no such file or directory". If you got this message, check your llvm and clang version.

./emcc --preload-file hello_world_file.txt tests/hello_world_file.c -o hello_world_file.html

Note that you must add "--preload-file hello_world_file.txt" in the command line. This line tells emcc that it should embed the file loading code into the js file. Before the application runs, all files will be loaded first. If you don't do this, it won't find this file.