mirror of https://github.com/bytecodealliance/wasm-micro-runtime.git synced 2025-02-06 06:55:07 +00:00

History

Enrico Loparco 6b1d81650d Allow not copying the wasm binary in wasm-c-api and not referring to the binary in wasm/aot loader (#3389 ) Add flag `LoadArgs.clone_wasm_binary` to control whether to clone the wasm/aot binary in wasm-c-api module. If false, API `wasm_module_new_ex` won't clone the binary, which may reduce the footprint. Add flag `LoadArgs.wasm_binary_freeable` to control whether the wasm/aot binary may be freed after instantiation for wamr API `wasm_runtime_load_ex`, if yes, then for some running modes, the wasm/aot module doesn't refer to the input binary again so developer can free it after instantiation to reduce the footprint. And add API `wasm_module_is_underlying_binary_freeable` and `wasm_runtime_is_underlying_binary_freeable` to check whether the input binary can be freed after instantiation for wasm-c-api and wamr api. And add sample to illustrate it.		2024-05-17 09:00:08 +08:00
..
src	Allow not copying the wasm binary in wasm-c-api and not referring to the binary in wasm/aot loader (#3389 )	2024-05-17 09:00:08 +08:00
wasm-apps	Fix sample basic intToStr was called with wrong length (#2876 )	2023-12-07 10:26:28 +08:00
.gitignore	Fix function type not set issue of aot_call_indirect (#229 )	2020-04-07 11:04:46 +08:00
build.sh	Allow not copying the wasm binary in wasm-c-api and not referring to the binary in wasm/aot loader (#3389 )	2024-05-17 09:00:08 +08:00
CMakeLists.txt	Allow not copying the wasm binary in wasm-c-api and not referring to the binary in wasm/aot loader (#3389 )	2024-05-17 09:00:08 +08:00
README.md	fix one typo in samples/basic.README.md (#274 )	2020-06-03 15:17:22 +08:00
run.sh	Add a basic sample to show how native runtime invokes wasm apps in WAMR and how wasm apps invoke native functions. (#207 )	2020-03-20 16:39:13 +08:00

README.md

The "basic" sample project

This sample demonstrates a few basic usages of embedding WAMR:

initialize runtime
load wasm app and instantiate the module
call wasm function and pass arguments
export native functions to the WASM apps
wasm function calls native function and pass arguments
deinitialize runtime

Build this sample

Execute the build.sh script then all binaries including wasm application files would be generated in 'out' directory.

$ ./build.sh

Run the sample

Enter the out directory.

$ cd ./out/
$
$ ./basic -f wasm-apps/testapp.wasm
calling into WASM function: generate_float
Native finished calling wasm function generate_float(), returned a float value: 102009.921875f
calling into WASM function: float_to_string
calling into native function: intToStr
calling into native function: get_pow
calling into native function: intToStr
Native finished calling wasm function: float_to_string, returned a formatted string: 102009.921

Or execute the run.sh script in samples/basic folder.

$ ./run.sh
calling into WASM function: generate_float
Native finished calling wasm function generate_float(), returned a float value: 102009.921875f
calling into WASM function: float_to_string
calling into native function: intToStr
calling into native function: get_pow
calling into native function: intToStr
Native finished calling wasm function: float_to_string, returned a formatted  string: 102009.921