webAssembly学习及使用rust

2024-04-20 09:04
文章标签 rust 学习 使用 webassembly

本文主要是介绍webAssembly学习及使用rust,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

学习理解 webAssembly 概念知识,使用 API 进行 web 前端开发。

概念

是一种运行在现代网络浏览器中的新型代码,并且提供新的性能特性和效果。它有一种紧凑的二进制格式,使其能够以接近原生性能的速度运行。C/C++、 C#、Rust等语言可以编译为 webAssembly 执行。

  • 快速、高效、可移植。不同平台中能够接近本地速度运行。
  • 可读、可调式。是一门低阶语言。
  • 保持安全。被限制运行在一个沙箱中,遵循浏览器的同源策略和授权策略。
  • 不破坏网络。向后兼容

以前无法以此方式运行的客户端软件都将可以运行在 Web 中。

WebAssembly 是一门不同于 JavaScript 的语言,它不是用来取代 JavaScript 的。相反,可以和 JavaScript 一起协同工作,从而使得网络开发者能够利用两种语言的优势

关键概念

  • 模块(module) - 表示一个已经被浏览器编译为可执行机器码的 WebAssembly 二进制代码
  • 内存(memory) - ArrayBuffer,大小可变。
  • 表格(table) - 带类型数组,大小可变
  • 实例(instance) - 一个模块及其在运行时使用的所有状态,包括内存、表格和一系列导入值

js 可以控制 WebAssembly 代码如何下载、编译运行。所以前端可以将 WebAssembly 作为一种高性能函数进行调用。

编写代码并应用

  • 构建完整基于 rust 的 web 应用,比如使用yew
  • 构建部分应用功能,比如提供一些方法,用于复杂的计算。

使用wasm-pack生成 webAssembly 代码

rust 环境参考另一篇文章rust 基础知识

wasm-pack可以构建生成与 js、浏览器、node 进行互操作的代码。可以将这些功能包发布到 npm 上。

安装,等待安装完成,可以通过wasm-pack -V查看版本,是否安装成功

wasm-pack

$> cargo install wasm-pack

创建一个 rust 项目js-utils,初始化为一个 lib 库cargo init --lib

配置Cargo.toml,添加wasm-binggen作为依赖,它是 wasm 与 js 之间交互的工具;添加crate-type设置为cdylib,指定该库是一个 C 兼容的动态库,这是针对 rust 编译时设置的一个标志。

添加依赖可以使用命令cargo add,在package字段中添加一些仓库、个人信息,比如authors/description/license/repository,在打包编译时,会被添加到package.json文件中

[package]
name = "js-utils"
version = "0.1.0"
edition = "2021"[lib]
crate-type = ['cdylib'][dependencies]
wasm-bindgen = "0.2.92"

开始写一些 rust 代码,在/src/lib.rs:

  • use wasm_bindgen::prelude::*; 导入所有wasm_bindgen的核心功能。以便后续直接调用
    #[wasm_bindgen]表明了下面的代码可以在 js 和 rust 中访问。

  • extern 将 js 函数导入 rust 中以供调用。代码中将alert函数声明后,在 rust 代码方法greet进行调用

use wasm_bindgen::prelude::*;#[wasm_bindgen]
extern "C" {fn alert(s: &str);
}#[wasm_bindgen]
pub fn greet(name: &str) {let str = format!("hello, World {name}");alert(&str);
}

为了方便测试,我们直接将这个发布为一个 npm 包

首先打包,--scope定义包命名空间

$> wasm-pack build --scope hboot

通过wasm-pack login登录你的 npm 账号,登录完成后,进入打包的目录下/pkg下进行发布

$> npm publish --access=public

发布完成后,就可以找一个前端项目测试安装发布的包。

$> npm i @hboot/js-utils

引入,调用greet函数,并传入自己的名称,启动服务,可以看到浏览器的弹窗。

在这我是采用本地软连接的方式导入到依赖中。

import * as jsUtils from "js-utils";jsUtils.greet("hboot");

wasm-pack-lib-success.png

官方提供了一个前端项目模板wasm-app模板,可以通过 npm 创建项目。

$> npm init wasm-app rust-lib-web

官方提供了一个基于 webpack 的混合应用程序模板rust-webpack,可以编写 rust 代码,实时测试效果

$> npm init rust-webpack rust-webpack-web

这个混合应用是通过配置@wasm-tool/wasm-pack-plugin插件,在运行时编译 rust 代码,加载编译包呈现在页面。

具体的代码可以查看仓库rust-web-lib; 😀😀😀

初次编译时间都非常久,下一次编译时就会快很多。

配置wasm-bindgen-test 进行单元测试

每次发布的包都是需要测试的,测试完成后才能进行发布。使用wasm-bindgen-test用于测试 wasm-pack 编译为 wasm 的 rust 程序。

添加依赖

$> cargo add wasm-bindgen-test

编写测试,创建目录tests/web.rs来存储一些测试案例。

在无头浏览器中测试,增加代码,通过执行wasm-pack test --firefox发起测试

use wasm_bindgen_test::*;wasm_bindgen_test_configure!(run_in_browser);

wasm-pack test --chrome执行测试提示chromedriver binaries are unavailable for this target估计是版本太新不匹配。

使用了 firefox 执行测试,运行成功,此时我们没有写任何的测试用例,会提示`no tests to run!。

和 rust 一样的测试书写方式,可以查看文章怎么写测试用例rust 自动化测试 ,区别就是把#[test]改为#[wasm_bindgen_test]

use js_utils;
use wasm_bindgen_test::*;#[wasm_bindgen_test]
fn alert_name() {js_utils::greet("hboot");js_utils::hello();
}wasm_bindgen_test_configure!(run_in_browser);

这里我们引入了当前项目作为依赖模块进行使用use js_utils,这里要注意的是 rust-wasm 和普通的 rust crate 不一样,我们需要指定crate-type = ["rlib"]才可以确保我们的库进行单元测试。

修改Cargo.toml:

[lib]
crate-type = ['cdylib', 'rlib']

好了,可以执行测试了wasm-pack test --firefox,看到如下输出:

wasm-pack-test-success.png

我们运行在浏览器中,测试启动一个服务将我们的代码运行在浏览器中,打开服务http://127.0.0.1:8000可以看到页面弹出的 alert

关闭弹窗,可以看到测试用例的运行情况:

wasm-pack-test-web-ok.png

默认情况下的wasm-pack test是在 node 环境下运行测试。

console_error_panic_hook将错误打印输出在浏览器中

在 rust 中代码出现逻辑错误,会panic!输出在控制台中,那我们调试前端 web 程序,肯定希望错误展现在浏览器中,方便查看。

安装依赖:

$> cargo add console_error_panic_hook

可以先看一下再没有使用console_error_panic_hook时,我们panic!信息,打包加载到我们测试项目中

without-console-error-panic.png

再配置使用console_error_panic_hook,有两种方式使用,我们使用第一种,可以去查看依赖文档了解。

use std::panic;#[wasm_bindgen]
pub fn greet(name: &str) {panic::set_hook(Box::new(console_error_panic_hook::hook));// ...panic!("测试错误信息!");
}

在函数最顶部调用一次panic hook,再次打包测试。可以看到效果,这极大的方便了开发测试,定位问题。

with-console-error-panic.png

所有辅助的包都会有一个问题,就是会占用空间。所以在开发测试时需要加上,而正式发布包时则不需要。那就需要一个配置

[dependencies]- console_error_panic_hook = "0.1.7"+ console_error_panic_hook = { version = "0.1.7", optional = true }

首先通过optional指定了这个依赖是可选的。然后通过命令参数--features指定启用哪些包,也可以配置包启用哪些特性。

当然,也可以使用Cargo.toml配置字段features来指定默认开启哪些依赖、特性。

[features]
default = []

此时,代码里就可以开启条件编译,通过#[cfg(feature = "console_error_panic_hook")]来标识

use std::panic;#[wasm_bindgen]
pub fn greet(name: &str) {#[cfg(feature = "console_error_panic_hook")]panic::set_hook(Box::new(console_error_panic_hook::hook));// ...panic!("测试错误信息!");
}

再次打包则需要通过--features来指定开启哪些。

  • --all-features - 全部开启;
  • --no-default-features - 不开启,默认不设置时则不开启。

可以在此打包测试下wasm-pack build,可以看到控制台已经没有具体的错误信息所在的文件、行数、调用栈。我们再次加上参数wasm-pack build --features 'console_error_panic_hook'

打包测试,可以看到有具体的错误信息了。

wee_alloc 内存分配器

针对 wasm 内存分配,它可以生成更小的.wasm代码体积。适用于那些需要少量初始化动态大小的内存分配。它没有全局的默认分配性能好,但是代码占用空间小。

安装依赖:

$> cargo add wee_alloc

需要在全局引用,代替默认的内存的分配器:

extern crate wee_alloc;// Use `wee_alloc` as the global allocator.
#[global_allocator]
static ALLOC: wee_alloc::WeeAlloc = wee_alloc::WeeAlloc::INIT;

配置前的打包体积大概是54kb,配置后整个包的体积为45kb。我们测试包仅仅只有一个文件,看起来差别不大,还是可以看出一点。

它也可以作为可选依赖,配置后可手动指定开启。

在需要性能优先的代码库中,则不推荐使用。

认识WebAssembly

在上面重点介绍了 rust 如何编译成 wasm,并引入使用。这边也要了解 WebAssembly 真正的是什么。

wasm-pack-build-pkg.png

可以看到我们之前的测试库打包后生成了.wasm文件,我们直接点击打开是不行的,提示此文件是二进制文件或使用了不受支持的文本编码,所以无法在文本编辑器中显示。

通过 vscode 的插件WebAssembly 可以查看内部的wasm内容。在插件市场查找并安装

wasm-source.png

完全看不懂 🫠 先来一个简单的示例测试测试。可以使用后缀为.wat格式的文件书写wasm代码

(module(func (export "add") (param $p1 i32)(param $p2 i32) (result i32)local.get $p1local.get $p2i32.add))

上面的代码就是一个简单的add两数之和。

  • func定义函数,
  • (export "add") 定义这个函数被导出,可以在 js 中调用。
  • params定义参数, $p1定义参数的别名,在下面需要读取。
  • result定义返回结果。
  • local.get 读取参数。没有别名时,指定参数下标local.get 0标识读取第一个参数。
  • i32.add 以上参数之和并返回。

利用插件将.wat转换为.wasm存储,准备引入使用。

wat-to-wasm.png

index.html利用 fetch 加载 wasm 文件

fetch("./index.wasm").then((res) => res.arrayBuffer()).then((bytes) => WebAssembly.instantiate(bytes)).then((res) => {console.log(res);});

查看最后的处理完的值,可看到res对象中存在instance对象包含了add方法

wasm-load-instance.png

这样我们就可以直接调用add方法了。

// ...
let num = res.instance.exports.add(35, 55);
alert(num);

可以看到执行效果了。这是一个简单的webAssembly示例,语法分析。

通过冒泡排序验证性能

要有强有力的验证说明,才能看到实际会提升多大的效果。rust 和 js 都使用自定义的冒泡排序算法,来执行上万条数据的排序, 看看执行时间做一个对比。

数据量少时,由于需要加载 wasm 所需的时间也会影响计算时间。在随着数据量变大,差距越来越大。

通过语言自带的排序算法可能由于内部各自实现的差异,执行效率受到其实现的影响。所以我们就自定义冒泡排序来测试

#[wasm_bindgen]
pub fn bublle_srot(arr: &mut [i32]) {let len = arr.len();for i in 0..len {for j in i+1..len {if arr[i] > arr[j] {arr.swap(i, j)}}}
}

在 js 中实现同样逻辑的算法,先用了一万条数据测试 js 比 wasm 快 4ms;数据增加大三万条时,js 明显就慢了,时间比 wasm 多了 100ms

bubble-sort-time.png

数据增大到五万条时,js 执行时间已经 wasm 慢了好几倍不止。

浏览器对数据排序应该是做了什么优化,第一次执行时间多出 wasm 好几倍;再次执行则多出几百毫秒。

通过 wasm 的加持,浏览器可以在更多领域施展拳脚。包括游戏、数据可视化、机器学习模型等。

这篇关于webAssembly学习及使用rust的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/919837

相关文章

C++使用栈实现括号匹配的代码详解

《C++使用栈实现括号匹配的代码详解》在编程中,括号匹配是一个常见问题,尤其是在处理数学表达式、编译器解析等任务时,栈是一种非常适合处理此类问题的数据结构,能够精确地管理括号的匹配问题,本文将通过C+... 目录引言问题描述代码讲解代码解析栈的状态表示测试总结引言在编程中,括号匹配是一个常见问题,尤其是在

Java中String字符串使用避坑指南

《Java中String字符串使用避坑指南》Java中的String字符串是我们日常编程中用得最多的类之一,看似简单的String使用,却隐藏着不少“坑”,如果不注意,可能会导致性能问题、意外的错误容... 目录8个避坑点如下:1. 字符串的不可变性:每次修改都创建新对象2. 使用 == 比较字符串,陷阱满

Python使用国内镜像加速pip安装的方法讲解

《Python使用国内镜像加速pip安装的方法讲解》在Python开发中,pip是一个非常重要的工具,用于安装和管理Python的第三方库,然而,在国内使用pip安装依赖时,往往会因为网络问题而导致速... 目录一、pip 工具简介1. 什么是 pip?2. 什么是 -i 参数?二、国内镜像源的选择三、如何

使用C++实现链表元素的反转

《使用C++实现链表元素的反转》反转链表是链表操作中一个经典的问题,也是面试中常见的考题,本文将从思路到实现一步步地讲解如何实现链表的反转,帮助初学者理解这一操作,我们将使用C++代码演示具体实现,同... 目录问题定义思路分析代码实现带头节点的链表代码讲解其他实现方式时间和空间复杂度分析总结问题定义给定

Linux使用nload监控网络流量的方法

《Linux使用nload监控网络流量的方法》Linux中的nload命令是一个用于实时监控网络流量的工具,它提供了传入和传出流量的可视化表示,帮助用户一目了然地了解网络活动,本文给大家介绍了Linu... 目录简介安装示例用法基础用法指定网络接口限制显示特定流量类型指定刷新率设置流量速率的显示单位监控多个

JavaScript中的reduce方法执行过程、使用场景及进阶用法

《JavaScript中的reduce方法执行过程、使用场景及进阶用法》:本文主要介绍JavaScript中的reduce方法执行过程、使用场景及进阶用法的相关资料,reduce是JavaScri... 目录1. 什么是reduce2. reduce语法2.1 语法2.2 参数说明3. reduce执行过程

如何使用Java实现请求deepseek

《如何使用Java实现请求deepseek》这篇文章主要为大家详细介绍了如何使用Java实现请求deepseek功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1.deepseek的api创建2.Java实现请求deepseek2.1 pom文件2.2 json转化文件2.2

python使用fastapi实现多语言国际化的操作指南

《python使用fastapi实现多语言国际化的操作指南》本文介绍了使用Python和FastAPI实现多语言国际化的操作指南,包括多语言架构技术栈、翻译管理、前端本地化、语言切换机制以及常见陷阱和... 目录多语言国际化实现指南项目多语言架构技术栈目录结构翻译工作流1. 翻译数据存储2. 翻译生成脚本

C++ Primer 多维数组的使用

《C++Primer多维数组的使用》本文主要介绍了多维数组在C++语言中的定义、初始化、下标引用以及使用范围for语句处理多维数组的方法,具有一定的参考价值,感兴趣的可以了解一下... 目录多维数组多维数组的初始化多维数组的下标引用使用范围for语句处理多维数组指针和多维数组多维数组严格来说,C++语言没

在 Spring Boot 中使用 @Autowired和 @Bean注解的示例详解

《在SpringBoot中使用@Autowired和@Bean注解的示例详解》本文通过一个示例演示了如何在SpringBoot中使用@Autowired和@Bean注解进行依赖注入和Bean... 目录在 Spring Boot 中使用 @Autowired 和 @Bean 注解示例背景1. 定义 Stud