Emscripten 编译器(emcc) 命令总结
emsdk 相关命令
命令 | 参数 | 说明 | 备注 |
---|
emsdk | | 帮助详情 | |
emsdk help | help | 帮助详情 | |
emsdk --help | –help | 帮助详情 | |
emsdk list [–old][–uses] | –old --uses | c 查询 Emscripten SDK 和 工具 列表 | 1.–old 返回所有版本;2. --users 返回不同 sdk 和依赖的组成 |
emsdk update | | 更新 sdk | git pull 等价 |
emsdk update-tags | | 更新 sdk | git pull 等价 |
emsdk uninstall <tool/sdk name> | | 安装 | |
emsdk install <tool/sdk name> | | 卸载 | |
emsdk activate <tool/sdk name> | | 设置当前 sdk | |
emcc 相关命令
命令 | 参数 | 说明 | 备注 |
---|
emcc --help | | 帮助详情 | |
emcc -O0 | -O0 | 包含所有断言(默认模式))) | 快速 build |
-O1 | -O1 | 简单优化,会移除断言,优化而二进制编译 | |
-O2 | -O2 | 比01 模式 优化 javascript | 压缩 js |
-O3 | -O3 | 比02 模式 更多优化 js | 编译时间长,发布版使用 |
-Os | -Os | 比03 模式 额外的体积优化;影响运行效率 | 影响 wasm 和 js 性能 |
-Oz | -Oz | 比03s 模式 进一步体积优化 | (不清楚实际情况,要多小是小) 更多参考 Optimizing Code |
-s | -s OPTION[=VALUE] | JavaScript 代码生成的选项 | 两种方式 1.直接传参( -s RUNTIME_LINKED_LIBS="[‘liblib.so’]");2.json 文件(-s DEAD_FUNCTIONS=@/path/to/file);更多参考 settings.js |
-g | -g | 保留 debug 信息 | 等同于 -g3 |
-g0 | -g0 | 尽量保持代码的可调试性 | |
-g1 | -g1 | 保留空格 | |
-g2 | -g2 | 保留函数名 | |
-g3 | -g3 | 保留 debug 信息 | 等同 -g |
-g4 | -g4 | source map 模式 | |
–profiling | –profiling | 生成 js 时使用默认值,增加可读性 | -g2 模式下 |
–profiling-funcs | –profiling-funcs | 生成 js 时,保留原函数名 | -g2 模式下 |
–tracing | –tracing | 启用 Emscripten 的 tracing API | 参考文档 tracing API |
–emit-symbol-map | –emit-symbol-map | 保存压缩文件和源文件的 function Names 的映射文件 | 适用于 “-O2”及其已上;并且 q 没有 “-g” 设置时 |
–js-opts | –js-opts <level> | js 优化器;“0”:不使用优化;“1”:使用优化 | “-O<level>” 下不需要设置该项 |
–llvm-opts | –llvm-opts <level> | LLVM 优化器;“0”:不使用优化(-O0);“1”: (-O1);“2”: (-O2);“3”: (-O3) | “-O<level>” 下不需要设置该项 |
–llvm-lto | –llvm-lto <level> | link-time optimizations [0-3] | 不稳定,不推荐使用 |
–closure | –closure <level> | 闭包编译器 ;“0”:不使用优化;“1”:使用优化(JavaScript code;不包括 WebAssembly 或 asm.js);“2”:使用优化 all | 不稳定,不推荐使用 |
–pre-js | –pre-js <file> | 处理前置入文件 | |
–post-js | –post-js <file> | 处理后置入文件 | |
–embed-file | –embed-file <file> | 指定要嵌入生成的 JavaScript 中的文件(文件或文件夹)) | “–embed-file dir/file.dat” |
–preload-file | –preload-file <file> | 预加载文件 存储在 filename.data ;xxx.html 存储在 xxx.html 和 xxx.data | “–embed-file dir/file.dat” |
–exclude-file | –exclude-file <file> | embed-file preload-file排除文件 | |
–use-preload-plugins | –use-preload-plugins <name> | 加载插件 | |
–shell-file | –shell-file <path> | HTML 的模板文件 | |
–source-map-base | –source-map-base <base-url> | source map 根目录 | |
–js-transform | –js-transform <cmd> | 编译器会将修改的和未修改的 | |
–bind | –bind | 使用 bindings Api | 参考文档 bind API |
–ignore-dynamic-linkin | –ignore-dynamic-linkin | 忽视动态链接 | |
----js-library | –js-library <lib> | | |
-v | -v | 开启所有打印 | |
–cache | –cache | 依赖缓存 | |
–clear-cache | –clear-cache | 清除依赖缓存 | |
–clear-cache | –clear-cache | 清除依赖缓存 | |
–show-ports | –show-ports | 展示编译端口 | |
–save-bc PATH | ----save-bc PATH | | … |
–memory-init-file | –memory-init-file <level> | 生成一个内存初始化文 ;0:关闭 1:开启 | … |
-Wwarn-absolute-paths | -Wwarn-absolute-paths | 启用在“-I”和“-L”命令行指令中使用绝对路径的警告 | … |
–proxy-to-worker | –proxy-to-worker | 启用 work.js | … |
–emrun | –emrun | 启用 work.js | … |
参考文档 github emsdk
参考文档 settings.js
参考文档 tracing API
参考文档 bind API