wasm.md

WebAssembly (WASM)

All the WebAssembly client code use Typescript and is inside directory wasm/sample/src/xplpc.

Requirements

• Node JS
• NPM
• Emscripten

Setup EMSDK variables

Execute on terminal inside your EMSDK installation folder:

source emsdk_env.sh
echo $EMSDK

How to build the library for WASM

Execute on terminal:

python3 xplpc.py wasm-build

or

cmake -S . -B build/wasm -DXPLPC_TARGET=wasm -DXPLPC_ADD_CUSTOM_DATA=ON -DCMAKE_TOOLCHAIN_FILE=${EMSDK}/upstream/emscripten/cmake/Modules/Platform/Emscripten.cmake -DCMAKE_BUILD_TYPE=Release
cmake --build build/wasm

How to build the WASM sample

Execute on terminal:

python3 xplpc.py wasm-build-sample

or

cd wasm/sample
npm install
npm run build

How to run the WASM sample

Execute on terminal:

python3 xplpc.py wasm-run-sample

or

cd wasm/sample
npm install
npm run dev

How to serve the WASM sample

Execute on terminal:

python3 xplpc.py wasm-serve-sample

or

cd wasm/sample
npm install
npm run build
cd dist
python3 -m http.server

How to test

Execute on terminal:

python3 xplpc.py wasm-test

or

cd wasm/sample
npm install
npm run test:unit

How to format the WASM code

Execute on terminal:

python3 xplpc.py wasm-format

Build parameters

You can build this target using some parameters to change configuration:

Build type:

--build debug

Dry run:

--dry

No dependencies:

--no-deps

Online demo

You can see the online demo on URL:

https://xplpc.github.io/wasm-demo/

Syntax sugar

You can use await to execute the method as async function, example:

const request = new XRequest(
    "sample.login",
    new XParam("username", "paulo"),
    new XParam("password", "123456"),
    new XParam("remember", true),
);

const response = await XClient.call<string>(request);
console.log("Returned Value: " + response);

Sample project

You can see the sample project in directory wasm/sample.