Asmble CLI终极命令手册：compile/invoke/translate核心功能详解

【免费下载链接】asmbleCompile WebAssembly to JVM and other WASM tools项目地址: https://gitcode.com/gh_mirrors/as/asmble

Asmble是一款强大的WebAssembly工具，能够将WebAssembly编译为JVM字节码并提供多种WASM工具功能。本文将详细介绍Asmble CLI的三大核心命令：compile、invoke和translate，帮助你快速掌握WebAssembly到JVM的编译与调用技巧。

一、编译命令：compile - 将WebAssembly转换为JVM类文件 🚀

compile命令是Asmble的核心功能，能够将WebAssembly文件（.wasm或.wast）编译为JVM类文件，实现WebAssembly在JVM环境中的运行。

1.1 基本语法与参数说明

asmble compile <inFile> <outClass> [options]

主要参数：

• inFile: WebAssembly源文件路径（支持.wasm或.wast格式，可使用--从标准输入读取）
• outClass: 生成的JVM类全名（如com.example.MyModule）
• --format: 指定输入格式（wast或wasm，默认根据文件扩展名判断）
• --out: 输出文件路径（默认生成<outClass>.class）
• --name: 模块名称（覆盖模块中定义的名称）
• --bindata: 将WASM二进制数据嵌入类注解中

1.2 实际应用示例

将名为module.wasm的文件编译为com.example.WasmModule类：

asmble compile module.wasm com.example.WasmModule --out target/classes

该命令会在target/classes/com/example/目录下生成WasmModule.class文件，实现了WebAssembly模块到JVM类的转换。相关实现逻辑可参考Compile.kt源代码。

二、调用命令：invoke - 执行WebAssembly函数 ⚡

invoke命令允许你直接调用已编译的WebAssembly模块中的导出函数，方便快速测试和验证WebAssembly代码功能。

2.1 基本语法与参数说明

asmble invoke <scriptArgs> [options]

主要参数：

• scriptArgs: 脚本参数（指定WebAssembly模块来源）
• --mod: 模块名称（默认为最后加载的模块）
• --export: 要调用的导出函数名（默认为模块的start函数）
• arg: 函数参数（可多个）
• --res: 将函数返回值输出到标准输出

2.2 实际应用示例

调用com.example.WasmModule模块中的add函数，传入参数3和5并输出结果：

asmble invoke -cp target/classes com.example.WasmModule --export add 3 5 --res

执行后会输出8，表示函数调用成功。该功能通过反射机制实现对编译后JVM类方法的调用，具体实现可见Invoke.kt。

三、转换命令：translate - WebAssembly格式互转 🔄

translate命令提供WebAssembly文本格式（WAT/WAST）与二进制格式（WASM）之间的相互转换，是WebAssembly开发和调试的实用工具。

3.1 基本语法与参数说明

asmble translate <inFile> [options]

主要参数：

• inFile: 输入文件路径（支持.wasm或.wast格式，可使用--从标准输入读取）
• --in: 指定输入格式（wast或wasm，默认根据文件扩展名判断）
• --out: 输出文件路径（默认输出到标准输出）
• --format: 指定输出格式（wast或wasm，默认根据文件扩展名判断或标准输出为wast）
• --compact: 输出紧凑格式的WAT（仅对WAT输出有效）

3.2 实际应用示例

将二进制格式的module.wasm转换为文本格式的module.wat：

asmble translate module.wasm --out module.wat --format wast

或者将文本格式转换为二进制格式：

asmble translate module.wat --out module.wasm --format wasm

转换功能的核心实现位于Translate.kt，通过inToAst和astToOut方法处理不同格式之间的转换。

四、快速入门：从安装到使用的完整流程

4.1 安装Asmble

首先克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/as/asmble cd asmble

使用Gradle构建项目：

./gradlew build

构建完成后，可在build/libs/目录下找到Asmble的可执行JAR文件。

4.2 常用命令组合示例

1. 将WAT文件转换为WASM：

asmble translate examples/rust-simple/src/lib.wat --out target/simple.wasm --format wasm

2. 编译WASM为JVM类：

asmble compile target/simple.wasm com.example.SimpleModule --out target/classes

3. 调用编译后的函数：

asmble invoke -cp target/classes com.example.SimpleModule --export add 10 20 --res

五、总结与进阶

Asmble CLI提供的compile、invoke和translate命令构成了WebAssembly到JVM开发的完整工具链。通过这些命令，开发者可以轻松实现WebAssembly代码的编译、调用和格式转换，为WebAssembly在JVM环境中的应用提供了便利。

如果你想深入了解Asmble的更多功能，可以查看项目中的示例代码，如examples/rust-simple展示了Rust编写的WebAssembly模块如何通过Asmble在JVM中运行。对于高级用户，还可以研究编译器的实现细节，如compiler/src/main/kotlin/asmble/compile/jvm/目录下的代码，了解WebAssembly到JVM的编译原理。

掌握Asmble CLI的使用，将为你的WebAssembly开发带来极大的便利，无论是前端还是后端开发者，都能从中受益。现在就开始尝试使用Asmble，体验WebAssembly与JVM结合的强大能力吧！

【免费下载链接】asmbleCompile WebAssembly to JVM and other WASM tools项目地址: https://gitcode.com/gh_mirrors/as/asmble