emcc编译与部分重要参数选取

(Owed by: 春夜喜雨 http://blog.csdn.net/chunyexiyu)
参考文档：

emcc是webassemble的编译器，类似于gcc的作用。

编译流程

emcc编译C/C++代码的流程：

C/C++代码通过emcc编译为字节码，然后根据不同的目标编译为asm.js或wasm。emcc和gcc编译选项类似，例如-s OPTIONS=VALUE、-O等。另外为了适应Web环境，emcc增加了一些特有的选项，如–pre-js 、–post-js 等。

emcc选项参数可以通过emcc -help察看
emcc --help

使用例子：

// 不带-O3, 生成的依赖项比较多一些
emcc temp.cc -o temp.js -s EXPORTED_FUNCTIONS='["_add", "_dec"]'

// 带-O3, 如果没有std::cout，则没有其它依赖项
emcc temp.cc -o temp.js -s EXPORTED_FUNCTIONS='["_add", "_dec"]' -O3

// 编译样例，使用ES6，线程中运行，生成单js文件
emcc -O3 -s EXPORT_ES6=1 -s ENVIRONMENT='worker' -s MODULARIZE_INSTANCE=1 -s EXPORT_NAME="test" -s WASM_ASYNC_COMPILATION=0 -s SINGLE_FILE=1 -s ALLOW_MEMORY_GROWTH=1 -s EXPORTED_FUNCTIONS="['_add', '_dec']" test.cc -o test.js12345678

部分重要的选项

// link选项 -O0时显示的日志调试信息最完整，生成的js文件的格式名称也都是易读的，强烈建议一开始调试时用该选项
// Note: O3 is a good setting for a release build
emcc -Oz > Os > O3 > O2 > O1 > O0 (O0-default)

// WASM=0生成asm.js格式(适用于WebAssembly不支持的情况)
// WASM=1生成包含wasm格式
// WASM=2 asm.js与wasm格式均生成，添加支持判定，优先使用wasm格式。
-s WASM=1 (0/1/2);

// 是否异步加载wasm，主线程需要用异步，worker中可以同步加载 // Whether to compile the wasm asynchronously
-s WASM_ASYNC_COMPILATION=1;

// 设定当前的运行环境，避免生成的js文件中判定环境，并运行不同的代码
// ‘web’ - the normal web environment.
// ‘worker’ - a web worker environment.
// ‘node’ - Node.js.
// ‘shell’ - a JS shell like d8, js, or jsc.
// e.g., “web,worker”. If this is the empty string, then all runtime environments are supported.
-s ENVIRONMENT=’’;

// 指定内存的大小和是否内存会增长
-s INITIAL_MEMORY=16777216
-s MAXIMUM_MEMORY=16777216
-s ALLOW_MEMORY_GROWTH=0/1

// 导出模块名称，常和MODULARIZE_INSTANCE/MODULARIZE配合使用
-s EXPORT_NAME=‘Module’;
// 是否生成模块instance(单例)，返回{}这种格式，并且初始化wasm
-s MODULARIZE_INSTANCE=0(0/1);
// 是否生成模块，返回function这种格式，模块可以初始化多个object
-s MODULARIZE=0(0/1);

// 是否导出ES6模式 Export using an ES6 Module export rather than a UMD export. MODULARIZE must be enabled for ES6 exports.
// It might not be supported on old browsers.
-s EXPORT_ES6=0/1

// js中内容尽量多的放入wasm中实现，减少依赖
-s STANDALONE_WASM = 0(0/1);

// If set to 1, embeds all subresources in the emitted file as base64 string literals
-s SINGLE_FILE = 0 (0/1);

// 是否是worker模式 If set to 1, this is a worker library, a special kind of library that is run
-s BUILD_AS_WORKER=0/1

// 设置输出的名称：需要提前定义该object={}，编译出的模块中会填充object函数方法 (用起来有一些问题)
-s EXPORT_NAME = ‘Module’;

(Owed by: 春夜喜雨 http://blog.csdn.net/chunyexiyu)