本节将从经典的"Hello, wolrd!"例程入手,介绍如何使用Emscripten编译C/C++代码并运行测试。
新建一个名为hello.cc的C源文件,为了正确标识中文字符串,将其保存为UTF8编码:
hello.cc
//hello.cc #include <stdio.h> int main() { printf("你好,世界!\n"); return 0; }
进入控制台,使用1.1节中介绍的emsdk_env命令设置Emscripten环境变量后,切换至hello.cc所在的目录,执行以下命令:
emsdk_env
emcc hello.cc
目录下将得到两个文件:a.out.wasm以及a.out.js。其中a.out.wasm为C源文件编译后形成的WebAssembly汇编文件;a.out.js是Emscripten生成的胶水代码,其中包含了Emscripten的运行环境和wasm的封装,导入a.out.js即可自动完成.wasm载入/编译/实例化、运行时初始化等繁杂的工作。
a.out.wasm
a.out.js
使用-o选项可以指定emcc的输出文件,执行下列命令:
-o
emcc
emcc hello.cc -o hello.js
编译后的成果文件分别为hello.wasm以及hello.js。
hello.wasm
hello.js
不同于NativeCode,C/C++被编译为WebAssembly以后是无法直接运行的,我们需要将它导入网页发布后,通过浏览器来执行。
在刚才的目录下,新建一个名为test.html的网页文件:
test.html
<!doctype html> <html> <head> <meta charset="utf-8"> <title>Emscripten:你好,世界!</title> </head> <body> <script src="hello.js"></script> </body> </html>
将该目录通过http协议发布后,使用浏览器打开test.html,打开开发者面板(Chrome浏览器下使用F12快捷键),我们将在控制台看到如下输出:
tips WebAssembly例程需通过http网页发布后方可运行。本书的例程目录中有一个名为"py_simple_server.bat"的批处理文件,该批处理用于在Windows操作系统下使用python将当前目录发布为http服务,端口为8000;当然您也可以使用nginx/IIS/apatch或任意一种惯用的工具来完成该操作。
WebAssembly程序不仅可以在网页中运行,也可以在Node.js 8.0及以上的版本中运行。Emscripten自带了Node.js环境,因此我们可以直接使用node来测试刚才的程序:
node
> node hello.js 你好,世界!
使用emcc命令时,若指定输出文件后缀为.html,那么Emscripten不仅会生成WebAssembly汇编文件.wasm、JavaScript环境胶水代码.js,还会额外生成一个Emscripten测试页面,例如下列命令:
.html
emcc hello.cc -o hello.html
执行后,将获得hello.wasm、hello.js以及hello.html。其中hello.wasm、hello.js与使用-o hello.js时获得的文件内容是一致的。将目录发布后使用浏览器访问hello.html,页面显示如下:
hello.html
-o hello.js
页面下方是一个模拟了标准控制台的输入输出区域;其上方较小的黑色区域是一个canvas画布,可用于模拟图形界面。页面自动载入了hello.js,并在控制台正确输出了“你好,世界!”
Emscripten自动生成的测试页面使用很方便,但是其页面代码量很大,不利于讲解,因此本书除特殊说明外,均使用手动编写的网页进行测试。
Copyright© 2013-2020
All Rights Reserved 京ICP备2023019179号-8