Marine Rust SDK

此SDK使开发者能够创建通用Wasm模块，并在interface-types和无共享链接方案的帮助下，以多模块设置组合它们。SDK提供了所有必要的宏和其他功能，使Wasm开发过程尽可能接近“vanilla”Rust。编译的模块旨在与Marine运行时一起运行。

用法

SDK的核心组件是应用于导出函数、外部块和结构的#[marine]宏。让我们考虑一个具有一个导出函数的简单模块场景

use marine_rs_sdk::marine;

#[marine]
pub fn greeting(name: String) -> String {
    format!("Hi, {}", name)
}

此代码导入Marine SDK并使用#[marine]宏包装问候函数。任何以这种方式包装的函数都将从编译的Wasm模块中导出。

要将此代码编译为Wasm，您需要Marine CLI工具。如果您尚未安装CLI，请使用cargo install marine

marine build --release

最后，您将获得一个嵌入到Wasm二进制文件中的构建清单，并可以与Marine REPL（mrepl）中的模块交互。如果您还没有它，请使用cargo install mrepl进行安装

> marine info ./target/wasm32-wasi/release/greeting.wasm
it version:  0.23.1
sdk version: 0.7.0
authors:     <user-name>
version:     0.1.0
description:
repository:
build time:  2023-02-15 18:52:37.865550 +00:00 UTC

> mrepl --quiet
1> load greeting ./target/wasm32-wasi/release/greeting.wasm
module successfully loaded into App service
elapsed time: 52.153308ms

2> interface
Application service interface:
greeting:
  fn greeting(name: String) -> String

3> call greeting greeting "user"
result: String("Hi, user")
 elapsed time: 132.021µs

有关开发此简单模块的完整指南，请参阅此处。

SDK组件

SDK导出以下主要组件

• #[marine]过程宏，可应用于
  • 函数使其从模块中导出
  • 外部块，以Marine兼容的方式导入模块
  • 结构体，使其可作为导出或导入函数的参数使用
• 调用参数接口，旨在提供一系列模块启动参数
• 挂载的二进制接口，可用于调用CLI工具
• module_manifest 宏，旨在将一些信息嵌入到编译后的Wasm中
• 日志记录功能，允许调整Marine日志机制