当前位置:

首页 > 系统应用 > WasmEdgeRustSDK发布新版本

WasmEdgeRustSDK发布新版本

伴随着 WasmEdge 0.10.1 发布,WasmEdge Rust bindings 的全新版本也闪亮登场:wasmedge-sdk v0.2.0 和wasmedge-sys v0.8.0。 你可以在 这里 找到相关 API 文档和源代码。下图显示了 WasmEdge Rust binding

本文目录

    伴随着 WasmEdge 0.10.1 发布,WasmEdge Rust bindings 的全新版本也闪亮登场:wasmedge-sdk v0.2.0 和wasmedge-sys v0.8.0。 你可以在 这里 找到相关 API 文档和源代码。

    下图显示了 WasmEdge Rust bindings 的架构。 wasmedge-sys crate 定义了一组低级 Rust API,它们简单地包了 WasmEdge C-API 并提供相应的安全版本,而 wasmedge-sdk 定义了一组围绕应用程序的高级 Rust API。

    我们建议大多数应用程序开发者使用 wasmedge-sdk crate。 因此,本文将重点介绍 wasmedge-sdk。 如果对 WasmEdge 低级 Rust API 的内部情况感兴趣,请可以查看wasmedge-sys 源代码。

    WasmEdge Rust bindings SDK 使 Rust 应用程序能够嵌入 WebAssembly 函数或模块。 这对于基于 Rust 的云原生或区块链基础设施软件特别有用,因为它们需要以安全有效的方式支持不受信任的用户函数。

    wasmedge-sdk crate 的主要设计目标是使开发者能够使用 WasmEdge 轻松安全地将第三方代码合并到他们的 rust 应用程序中。 wasmedge-sdk crate 旨在为 Rust 开发者提供顺滑的体验。

    下面让我们来看一个简单的例子吧!

    从 wasmedge-sdk 开始

    这个例子展示了如何从 Rust 程序运行 WasmEdge host 函数。 该函数也是用 Rust 编写的。 你也可以使用 C、TinyGo 或 Ja vaScript 等编程语言编写 WasmEdge 函数。

    这里我们使用一个简单的 hello world 程序来解释 wasmedge-sdk 是如何工作的。 此示例演示了如何完成以下工作。

    1.通过ImportObjectBuilder 加载第三方 native 函数2.加载 native 函数生成的 Wasm 模块

    有关 wasmedge-sdk 的更多示例,请查看此处。

    首先,确保已经在本地系统上安装了 Rust 和 WasmEdge。 如果想使用 WasmEdge 的 WasmEdgeProcess 插件,请注意 Linux 是唯一支持的操作系统。

    接下来,从 WasmEdge repo 中获取 wasmedge-sdk 示例。

    $ git clone https://github.com/WasmEdge/WasmEdge.git
    $ cd /bindings/rust/

    然后,使用下面的命令行从 wasmedge-sdk 文件运行 hello world 示例。

    cargo run -p wamedge-sdk --example hello_world -- --nocapture

    如果命令行成功运行,会看到 Hello, world! 在终端中打印出来,如下图所示。

    现在让我们深入研究代码。 上述 Hello World 示例的源代码可以在这里找到。

    让我们立即获取所有 imports 并开始:

    // 如果使用 < 1.63 版本的 rust,请添加此特性
    // #![feature(explicit_generic_args_with_impl_trait)]

    use wasmedge_sdk::{params, Executor, ImportObjectBuilder, Module, Store};
    use wasmedge_sys::WasmValue;
    use wasmedge_types::wat2wasm;

    定义一个 native 函数并创建一个 ImportObject

    首先,让我们定义一个名为 say_hello_world 的 native 函数,它会打印出 Hello, World!。

    fn say_hello_world(_inputs: Vec) -> Result, u8> {
    println!("Hello, world!");

    Ok(vec![])
    }

    在WasmEdge runtime里,若要将native函数用作import函数,那就得有一个ImportObject。wasmedge-sdk定义了一个ImportObjectBuilder,它提供了一系列用于创建ImportObject的链式方法。下面我们来瞧瞧具体的方法:

    // 创建一个 import 模块
    let import = ImportObjectBuilder::new()
    .with_func::<(), ()>("say_hello", say_hello_world)?
    .build("env")?;

    现在,我们有一个名为 env 的 import 模块,它包含一个 host 函数 say_hello。 也许你注意到,我们用于 import 模块和 host 函数的名称与 Wasm 模块中间出现的名称完全相同。 可以在下一节中找到 Wasm 模块。

    加载一个 wasm 模块

    现在我们加载一个 Wasm 模块。 wasmedge-sdk 在 Module 中定义了两个方法:

    • from_file 从文件加载一个 Wasm 模块,并且同时验证已经加载的模块。

    • from_bytes 从内存字节数组中加载一个 Wasm 模块,同时验证加载的 Wasm 模块。

    这里我们选择使用 Module::from_bytes 方法从内存字节数组中加载我们的 Wasm 模块。

    let wasm_bytes = wat2wasm(
    br#"
    (module
    ;; First we define a type with no parameters and no results.
    (type $no_args_no_rets_t (func (param) (result)))

    ;; Then we declare that we want to import a function named "env" "say_hello" with
    ;; that type signature.
    (import "env" "say_hello" (func $say_hello (type $no_args_no_rets_t)))

    ;; Finally we create an entrypoint that calls our imported function.
    (func $run (type $no_args_no_rets_t)
    (call $say_hello))
    ;; And mark it as an exported function named "run".
    (export "run" (func $run)))
    "#,
    )?;

    // 从给定的内存字节加载一个 Wasm 模块并返回一个编译的模块
    let module = Module::from_bytes(None, &wasm_bytes)?;

    注册 import 模块和编译模块

    注册已编译模块时,需检查其是否依赖某些import模块。在Wasm模块中,这条语句 (import "env" "say_hello" (func $say_hello (type $no_args_no_rets_t))) 表明,它依赖于名为 env 的import模块。所以,在注册编译好的wasm模块前,得先注册import模块。

    // 创建一个 executor
    let mut executor = Executor::new(None, None)?;

    // 创一个 store
    let mut store = Store::new()?;

    // 将 import 模块注册到 store 中
    store.register_import_module(&mut executor, &import)?;

    // 将编译好的模块注册到 store 中,并得到一个模块实例
    let extern_instance = store.register_named_module(&mut executor, "extern", &module)?;

    在上面的代码中我们使用 Executor 和 Store 来注册 import 模块和已编译模块。wasmedge-sdk 也提供其它 APIs 来做同样的工作: Vm::register_import_module 和 Vm::register_module_from_bytes。

    运行导出的函数

    现在可以运行导出的函数。

    // 获取导出的函数 "run"
    let run = extern_instance
    .func("run")
    .ok_or_else(|| anyhow::Error::msg("Not found exported function named 'run'."))?;

    // 运行 host 函数
    run.call(&mut executor, params!())?;

    展望未来

    很快,wasmedge-sdk 将添加对嵌入式 Wasm 和异步 host 函数的异步调用的支持。 另一个重要特性是支持 wasmedge-sdk 中的复杂接口类型,允许开发者将复杂的数据结构(如字符串和用户定义的复杂类型)传递给 Wasm VM。

    为 wasmedge-sdk 的开发做贡献

    wasmedge-sdk 还在开发中,期待社区的反馈。 下面是需要社区小伙伴帮助的类目。此外,针对每一次反馈,我们会寄出礼物作为感谢。在这里查看规则。

    • 试试 wasmedge-sdk,让我们知道如何改进。 此外,如果有任何问题,请提 issue。
    • Bug 报告。 不可避免地,有一些我们没有涵盖的边缘测试用例。 如果发现新的 bug,请随时提出 issue 并告诉我们。
    • 查看文档。 文档对于开源软件来说是必不可少的。 如果发现文档有问题,请不要犹豫提 issue 或创建 PR 来修正。
    • 提出功能需求。 wasmedge-sdk 目前的特性来自我们用户的真实需求。 如果你有想到好的主意,请通过 issue 告诉我们。
    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    系统应用 Rust
    相关文章 更多
    rust-analyzer v0.3.3121 稳定版修复怎样影响常量与条件属性?
    rust-analyzer v0.3.3121 稳定版修复怎样影响常量与条件属性?

    rust-analyzer v0.3.3121 稳定版修复大 u128 转为负浮点数的问题,并为 target_os 与 target_env 补齐 macOS、iOS、Android 和 musl 相关候选。

    Rust 1.100.0发布:never类型稳定,旧版edition与Cargo缓存需检查
    Rust 1.100.0发布:never类型稳定,旧版edition与Cargo缓存需检查

    Rust 1.100.0稳定了never类型和自定义分配器核心API,并带来Cargo未使用依赖提示、构建目录布局调整和依赖冷却配置。升级时应优先验证旧edition的类型推断,以及自行依赖Cargo缓存路径的构建脚本。

    rust下载安装教程详解及Windows环境配置方法
    rust下载安装教程详解及Windows环境配置方法

    详解Windows系统下Rust语言的安装步骤,重点解析rustup工具链管理机制,解决环境变量配置错误及MSVC链接器缺失问题,提供可复制的命令验证方法与常见报错的因果排查思路。

    Rust 1.93.0 稳定版发布
    Rust 1.93.0 稳定版发布

    Rust1.93.0稳定版本正式发布:musl库升级至1.2.5并完全重构DNS解析器,显著提升性能与安全性;全局分配器新增线程局部存储支持,大幅降低锁竞争;asm!宏内联新增cfg属性,显著增强条件编译能力;同时还稳定了MaybeUninit、Vec、VecDeque等多项实用API。

    CnosDB涅槃重生:弃用Go,全面拥抱Rust
    CnosDB涅槃重生:弃用Go,全面拥抱Rust

    想必CnosDB社区的各位爱码士们,最近都留意到了,基于Rust版本的CnosDB Isipho已迁移至GitHub主站,而Go版本的CnosDB,社区团队也不再对其进行维护与支持了。在此,首先要向大家致以诚恳的歉意,之前计划与决策的仓促,给大家造成了不必要的困扰。但出于对社区负责的考量,这里为大家

    Salvo Rust Web 框架 0.89.0 发布
    Salvo Rust Web 框架 0.89.0 发布

    SalvoRustWeb框架0.89.0正式发布,新增salvo-tus模块,完整支持TUS协议,大幅提升大文件上传效率;改进枚举数据解析,强化表单上传限制与安全性;升级bcrypt、nix等依赖库,集成unix-sock-client,支持quinn自由选择TLS提供者;增强OpenAPI泛型识别能力,以及Depot结构化数据提取功能。

    Rust对象中的结构体、枚举、特性详解
    Rust对象中的结构体、枚举、特性详解

    1 结构体 先从结构体说起。Rust 把数据组织成整体有两种方式:元组和结构体。元组灵活但没名字,结构体给每个字段起了名字,用起来更直观。结构体在代码里很常见,用来定义常用的数据结构,每个成员叫“字段”。 1.1 简介 1.1.1 定义 Rust 的结构体与元组都可以把一堆类型不同的数据捆绑成整体,

    深入浅析Rustcollect()
    深入浅析Rustcollect()

    在Rust语言中,迭代器的`collect()`是一个重要的终端操作,主要用于消费惰性迭代器链并收集到具体的集合类型(如Vec、HashSet等)。在调用前,整个链子不执行任何操作,其类型由左值注解自动推导,从而支持灵活切换容器。

    银河麒麟下怎么安装和配置Rust开发环境
    银河麒麟下怎么安装和配置Rust开发环境

    在银河麒麟系统搭建Rust环境,需确认底层发行版,安装构建工具,用rustup配合清华镜像安装工具链,配置crates.io国内镜像,并安装rust-src组件,否则下载易卡死或编译失败。

    VSCode运行Rust代码教程 VSCode安装Rust插件方法
    VSCode运行Rust代码教程 VSCode安装Rust插件方法

    rust-analyzer仅提供代码分析与补全,不包含运行功能。运行Rust程序需通过终端或VSCode任务系统。常见问题包括:插件冲突、未正确设置环境变量导致命令找不到、未在包含Cargo.toml的目录中打开项目。确保终端可正常执行cargorun是解决一切问题的基础。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。