本节适用于，希望支持 WebAssembly 的通用箱作者。

查看有关什么样的事情能让一个通用箱 不能 移植到 WebAssembly的信息。如果您的箱子没有任何这些东西，它可能已经支持 WebAssembly!

您可以随时通过运行cargo build，检查 WebAssembly 目标:

cargo build --target wasm32-unknown-unknown

如果该命令失败，那么您的 crate 现在不支持 WebAssembly。如果它没有失败，那么你的箱子不一定支持 WebAssembly。但你可以 100% 确定它(继续跟着做!)为 wasm 添加测试 ，还有在 CI 上运行这些测试。

在 Web 上，I/O 始终是异步的，且时没有文件系统。从库中分出 I/O 因素吧，让用户以为自己在执行 I/O，但其实将输入 slice 传递到库中。

例如,重构这个:

# #![allow(unused_variables)]
#fn main() {
use std::fs;
use std::path::Path;

pub fn parse_thing(path: &Path) -> Result<MyThing, MyError> {
    let contents = fs::read(path)?;
    // ...
}
#}

进入这个:

# #![allow(unused_variables)]
#fn main() {
pub fn parse_thing(contents: &[u8]) -> Result<MyThing, MyError> {
    // ...
}
#}

如果您需要与外界进行互动(即，您不能让 库 的使用者为您推动这种互动)，那么您需要添加wasm-bindgen(还有js-sys和web-sys，若你需要它们)作为编译 WebAssembly 目标的依赖项:

[target.'cfg(target_arch = "wasm32")'.dependencies]
wasm-bindgen = "0.2"
js-sys = "0.3"
web-sys = "0.3"

如果你必须在库中执行 I/O，那它不能同步。Web 上只有异步 I/O。使用futures箱和wasm-bindgen-futures箱管理异步 I/O。如果您的库函数为某些 future 类型F的通用函数，那么 future 是可以实现的，可能是通过在 Web 上fetch，或是通过操作系统提供的非阻塞 I/O。

# #![allow(unused_variables)]
#fn main() {
pub fn do_stuff<F>(future: F) -> impl Future<Item = MyOtherThing>
where
    F: Future<Item = MyThing>,
{
    // ...
}
#}

您还可以为 WebAssembly 和 Web 以及本机目标，定义一个 trait 并实现它:

# #![allow(unused_variables)]
#fn main() {
trait ReadMyThing {
    type F: Future<Item = MyThing>;
    fn read(&self) -> Self::F;
}

#[cfg(target_arch = "wasm32")]
struct WebReadMyThing {
    // ...
}

#[cfg(target_arch = "wasm32")]
impl ReadMyThing for WebReadMyThing {
    // ...
}

#[cfg(not(target_arch = "wasm32"))]
struct NativeReadMyThing {
    // ...
}

#[cfg(not(target_arch = "wasm32"))]
impl ReadMyThing for NativeReadMyThing {
    // ...
}
#}

Wasm 还不支持线程(但是实验型工作还是在继续)，所以试图在 wasm 中产生线程会引起恐慌。

您可以使用#[cfg(..)]启用代码路径，是不是线程和非线程，具体取决于目标是否为 WebAssembly:

# #![allow(unused_variables)]
#![cfg(target_arch = "wasm32")]
#fn main() {
fn do_work() {
    // 只使用这个线程…
}

#![cfg(not(target_arch = "wasm32"))]
fn do_work() {
    use std::thread;

    // 将工作扩展到助手线程….
    thread::spawn(|| {
        // ...
    });
}
#}

另一种选择是将从库中生成的线程分离出来，并允许用户带上“自己的线程”，类似于将文件 I/O 分离出来，并允许用户带上自己的 I/O。这有一个副作用，就是对想要拥有自己自定义线程池的应用程序要进行友好处理。

维护对 WebAssembly 的持续支持

通过让 CI 脚本运行以下命令，确保为 WebAssembly 目标时编译不会失败:

rustup target add wasm32-unknown-unknown
cargo check --target wasm32-unknown-unknown

例如,您可以将此 Travis CI 的配置添加到您的.travis.yml:

matrix:
  include:
    - language: rust
      rust: stable
      name: 'check wasm32 support'
      install: rustup target add wasm32-unknown-unknown
      script: cargo check --target wasm32-unknown-unknown

您可以在 Node.js 或无头浏览器中，使用wasm-bindgen-test和wasm-pack test子命令，运行 wasm 测试。您甚至可以将这些测试集成到 CI 中。

学习 ，更多 测试 wasm 的资源