`wasm-bindgen` 教程

1. 项目目录结构及介绍

在wasm-bindgen项目中，您通常会发现以下基本目录结构：

project-name/
│
├── Cargo.toml       # 项目的元数据，包括依赖关系
├── src/             # 主要的Rust源代码目录
│   ├── lib.rs      # 库代码（用于编译到WASM）
│   └── main.rs     # 程序入口（如果有的话，通常是命令行应用）
├── wasm-bindgen.toml # 可选的配置文件（如果存在的话）
└── tests/           # 测试代码
    └── lib.rs        # 测试用例

• Cargo.toml：项目的核心配置文件，定义了项目的名称、版本以及依赖。
• src/：代码存放目录。
  • lib.rs：通常包含了编译成WebAssembly的库代码。
  • main.rs：如果有的话，是命令行应用程序的起点。
• wasm-bindgen.toml：可选的配置文件，用于自定义wasm-bindgen的行为。
• tests/：测试代码，用于验证你的WASM绑定功能。

2. 项目的启动文件介绍

在Rust中，main.rs或lib.rs被用作启动文件。具体取决于你是创建一个独立的应用程序还是一个库。

• 如果是库（如WASM模块）：src/lib.rs是主要的源代码文件，其中mod声明将定义模块结构。wasm-bindgen会处理这个文件来生成JavaScript绑定。

• 如果是命令行应用：src/main.rs是入口点，它会调用你的库中的函数。对于WebAssembly项目，通常不会有单独的main()函数，因为WASM通常作为其他环境（如浏览器脚本或Node.js）的一部分运行。

启动文件通常包含use语句以引入必要的库和#[wasm_bindgen]装饰器来导出到JavaScript的函数或类型。

例如，在lib.rs中：

// 引入预定义的模块
use wasm_bindgen::prelude::*;

// 导出到JavaScript的函数
#[wasm_bindgen]
pub fn my_function() {
    // ...
}

3. 项目的配置文件介绍

wasm-bindgen.toml是一个可选的配置文件，可以用于指定wasm-bindgen工具的特定行为。例如，你可以在这里定义自定义的JavaScript代码生成规则，或者指定不进行某些转换。这里是一些可能的配置示例：

[custom]
js_code = [
    "console.log('Custom JavaScript loaded!');"
]

[features]
default = []
no_napi = true

• [custom]部分允许你在生成的JavaScript代码中添加自定义的片段。
• [features]部分可以启用或禁用特定的功能标志。

然而，不是所有的项目都需要wasm-bindgen.toml文件，通常仅在有特殊需求时才使用。

---

通过理解以上目录结构、启动文件和配置文件的概念，你应该能够更好地入门wasm-bindgen项目。现在你可以继续阅读官方文档、教程和例子，进一步探索如何构建JavaScript和WebAssembly之间的交互。祝你好运！