#wasm-js #inline #js #wasm #build-script #javascript #wasm-build

构建 embed_js

针对通过 wasm32-unknown-unknown 目标针对WebAssembly的Rust应用程序的极简轻量级内联JavaScript。另见 embed_js_build,用于构建脚本的配套crate。

5个版本

使用旧的Rust 2015

0.1.4 2017年12月21日
0.1.3 2017年12月18日
0.1.2 2017年12月17日
0.1.1 2017年12月17日
0.1.0 2017年12月17日

#445构建工具

MIT/Apache

7KB

embed_js

针对通过 wasm32-unknown-unknown 目标针对WebAssembly的Rust应用程序的极简轻量级内联JavaScript。

该项目提供了一个低级接口,专为其他crate设计,以便在顶部构建更高级、更易用的API。

入门

尝试运行示例(在examples子目录中),以了解各个部分是如何结合在一起的。

要构建wasm应用程序,请确保您已安装最新的Rust nightly版本和wasm32-unknown-unknown目标。

设置示例

示例需要安装 cargo-makecargo-scriptwasm-gc

在示例目录中,请确保您已设置好rustup以使用nightly Rust进行构建。

使用 cargo make 构建示例,这确保了运行了后构建脚本。生成的自包含HTML文件应在 "target/wasm32-unknown-unknown/release/" 中,并且可以在支持WebAssembly的浏览器中运行。

根据示例,您可能需要检查浏览器中的控制台日志(F12)以查看其输出。

通用用法

有两个crate可供使用。 embed_js 是用于使用 js 宏嵌入JavaScript的crate。 embed_js_build 应在构建脚本中作为预处理阶段使用。 embed_js_build 也应由构建wasm二进制文件的应用程序crate在其 -构建脚本中使用,以便在加载wasm模块时导入生成的配套JavaScript。

有关更详细的用法信息,请参阅这两个crate的文档,或查看此存储库中的示例。

embed_js 文档

embed_js_build 文档

[dependencies]
embed_js = "^0.1.4"
[build-dependencies]
embed_js_build = "^0.1.4"

限制

目前,js 宏不能在其他宏内使用,除了 include! 宏。这可能在将来得到修复。

许可证

许可协议为以下之一

您可以选择使用。

贡献

除非您明确声明,否则您根据 Apache-2.0 许可证定义的任何有意提交以包含在作品中的贡献,将按照上述方式双重许可,不附加任何额外的条款或条件。

依赖项

~1.4–2MB
~44K SLoC