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 在 构建工具
7KB
embed_js
针对通过 wasm32-unknown-unknown
目标针对WebAssembly的Rust应用程序的极简轻量级内联JavaScript。
该项目提供了一个低级接口,专为其他crate设计,以便在顶部构建更高级、更易用的API。
入门
尝试运行示例(在examples子目录中),以了解各个部分是如何结合在一起的。
要构建wasm应用程序,请确保您已安装最新的Rust nightly版本和wasm32-unknown-unknown目标。
设置示例示例需要安装 cargo-make、cargo-script 和 wasm-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 License, Version 2.0, (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
- MIT 协议 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)
您可以选择使用。
贡献
除非您明确声明,否则您根据 Apache-2.0 许可证定义的任何有意提交以包含在作品中的贡献,将按照上述方式双重许可,不附加任何额外的条款或条件。
依赖项
~1.4–2MB
~44K SLoC