10 个版本 (6 个稳定版)
2.3.0 | 2022年6月6日 |
---|---|
2.2.1 | 2022年3月16日 |
2.2.0 | 2022年2月28日 |
2.2.0-rc1 | 2022年1月28日 |
2.0.0 | 2021年6月16日 |
#1476 in WebAssembly
1,039 个月下载量
1MB
18K SLoC
Wasmer Engine Staticlib
这是一个用于 wasmer WebAssembly 虚拟机(VM)的 引擎。
此引擎用于生成一个原生静态库对象,可以链接到提供沙箱 WebAssembly 运行时环境,无需运行时编译。
使用示例
首先,我们使用 Wasmer 编译我们的 WebAssembly 文件
wasmer compile path/to/wasm/file.wasm --llvm --staticlib -o my_wasm.o --header my_wasm.h
您将看到类似以下输出
Engine: staticlib
Compiler: llvm
Target: x86_64-apple-darwin
✔ File compiled successfully to `my_wasm.o`.
✔ Header file generated successfully at `my_wasm.h`.
现在让我们创建一个程序来链接这个静态对象文件。
#include "wasmer.h"
#include "my_wasm.h"
#include <stdio.h>
#include <stdlib.h>
#define own
static void print_wasmer_error()
{
int error_len = wasmer_last_error_length();
printf("Error len: `%d`\n", error_len);
char* error_str = (char*) malloc(error_len);
wasmer_last_error_message(error_str, error_len);
printf("Error str: `%s`\n", error_str);
free(error_str);
}
int main() {
printf("Initializing...\n");
wasm_config_t* config = wasm_config_new();
wasm_config_set_engine(config, STATICLIB);
wasm_engine_t* engine = wasm_engine_new_with_config(config);
wasm_store_t* store = wasm_store_new(engine);
wasm_module_t* module = wasmer_staticlib_engine_new(store, "qjs.wasm");
if (!module) {
printf("Failed to create module\n");
print_wasmer_error();
return -1;
}
// We have now finished the memory buffer book keeping and we have a valid Module.
// In this example we're passing some JavaScript source code as a command line argument
// to a WASI module that can evaluate JavaScript.
wasi_config_t* wasi_config = wasi_config_new("constant_value_here");
const char* js_string = "function greet(name) { return JSON.stringify('Hello, ' + name); }; print(greet('World'));";
wasi_config_arg(wasi_config, "--eval");
wasi_config_arg(wasi_config, js_string);
wasi_env_t* wasi_env = wasi_env_new(wasi_config);
if (!wasi_env) {
printf("> Error building WASI env!\n");
print_wasmer_error();
return 1;
}
wasm_importtype_vec_t import_types;
wasm_module_imports(module, &import_types);
int num_imports = import_types.size;
wasm_extern_t** imports = (wasm_extern_t**) malloc(num_imports * sizeof(wasm_extern_t*));
wasm_importtype_vec_delete(&import_types);
bool get_imports_result = wasi_get_imports(store, module, wasi_env, imports);
wasi_env_delete(wasi_env);
if (!get_imports_result) {
printf("> Error getting WASI imports!\n");
print_wasmer_error();
return 1;
}
wasm_instance_t* instance = wasm_instance_new(store, module, (const wasm_extern_t* const*) imports, NULL);
if (! instance) {
printf("Failed to create instance\n");
print_wasmer_error();
return -1;
}
// WASI is now set up.
own wasm_func_t* start_function = wasi_get_start_function(instance);
if (!start_function) {
fprintf(stderr, "`_start` function not found\n");
print_wasmer_error();
return -1;
}
fflush(stdout);
own wasm_trap_t* trap = wasm_func_call(start_function, NULL, NULL);
if (trap) {
fprintf(stderr, "Trap is not NULL: TODO:\n");
return -1;
}
wasm_instance_delete(instance);
wasm_module_delete(module);
wasm_store_delete(store);
wasm_engine_delete(engine);
return 0;
}
我们将源代码保存到 test.c
并运行
clang -O2 -c test.c -o test.o
现在我们只需要将所有东西链接在一起
clang -O2 test.o my_wasm.o libwasmer.a
我们将我们创建的静态对象文件、使用 Wasmer 生成的对象文件以及 libwasmer
链接在一起,生成一个可以调用编译的 WebAssembly 的可执行文件!
依赖关系
~8–19MB
~280K SLoC