77e17d8f71
* Add a wasmtime-specific `wasmtime_wat2wasm` C API This commit implements a wasmtime-specific C API for converting the text format to the binary format. An upstream spec issue exists for adding this to the C API, but in the meantime we can experiment with our own version of this API and use it in the C# extension, for example! Closes #1000 * Reorder arguments * Use wasm_byte_vec_t for input `*.wat` * Mark wat input as const * Return an error message and use `fixed` * Actually include the error message * Use `fixed` in `Module.cs` as well
Wasmtime for .NET
A .NET API for Wasmtime.
Wasmtime for .NET enables .NET code to instantiate WebAssembly modules and to interact with them in-process.
Getting Started
Prerequisites
.NET Core 3.0
Install a .NET Core 3.0+ SDK for your operating system.
Introduction to Wasmtime for .NET
See the introduction to Wasmtime for .NET for a complete walkthrough of how to use Wasmtime for .NET.
Wasmtime for .NET API documentation
See the Wasmtime for .NET API documentation for documentation on using the Wasmtime for .NET types.
Running the "Hello World" Example
The "hello world" example demonstrates a simple C# function being called from WebAssembly.
To run the "hello world" example, follow these instructions:
cd examples/hellodotnet run
You should see a Hello from C#, WebAssembly! message printed.
Building Wasmtime for .NET
To build Wasmtime for .NET, follow these instructions:
cd src.dotnet build.
This should produce a Wasmtime.Dotnet.dll assembly in the bin/Debug/netstandard2.1 directory.
To build a release version of Wasmtime for .NET, follow these instructions:
cd src.dotnet build -c Release.
This should produce a Wasmtime.Dotnet.dll assembly in the bin/Release/netstandard2.1 directory.
Running the tests
To run the Wasmtime for .NET unit tests, follow these instructions:
cd tests.dotnet test.
Packing Wasmtime for .NET
To create a NuGet package for Wasmtime for .NET, follow these instructions:
cd src.dotnet pack -c Release.
This should produce a Wasmtime.<version>.nupkg file in the bin/Release directory.
Implementation Status
Status
| Feature | Status |
|---|---|
| Wasmtime engine class | ✅ |
| Wasmtime store class | ✅ |
| Wasmtime module class | ✅ |
| Wasmtime instance class | 🔄 |
| Module function imports | ✅ |
| Module global imports | ✅ |
| Module table imports | ✅ |
| Module memory imports | ✅ |
| Module function exports | ✅ |
| Module global exports | ✅ |
| Module table exports | ✅ |
| Module memory exports | ✅ |
| Extern instance functions | ✅ |
| Extern instance globals | ✅️ |
| Extern instance tables | ⬜️ |
| Extern instance memories | ✅️ |
| Host function import binding | ✅ |
| Host global import binding | ✅ ️️ |
| Host table import binding | ⬜️ ️️ |
| Host memory import binding | ✅️ ️️ |
i32 parameters and return values |
✅ |
i64 parameters and return values |
✅ |
f32 parameters and return values |
✅ |
f64 parameters and return values |
✅ |
AnyRef parameters and return values |
⬜️ |
| Tuple return types for host functions | ✅ |
| Trap messages | ✅ |
| Trap frames | ⬜️ |
| Create a NuGet package | ✅ |
Legend
| Status | Icon |
|---|---|
| Not implemented | ⬜️ |
| In progress | 🔄 |
| Completed | ✅ |