Icon Link入门指南

Icon Link安装指南

请访问 Fuel 的 安装指南 Icon Link 来安装 Fuel 工具链二进制文件和先决条件。

forc 是 Rust 的 cargo 的 Sway 等效工具。 fuel-core 是 Fuel 完整节点的实现。

您可以使用 Fuel Rust SDK 的两种主要方式：

1. 使用 forc 创建一个新的 Sway 项目并运行测试
2. 创建一个独立项目并导入 fuels-rs crate

Icon Link使用 Forc 创建一个新项目

您可以使用以下命令创建一个新的 Sway 项目：

forc new <Project name>

或者您可以在现有文件夹中初始化一个项目：

forc init

Icon Link在 Sway 项目中添加 Rust 集成测试

现在我们有了一个新项目，我们可以使用 cargo generate 模板添加一个 Rust 集成测试。 如果尚未安装 cargo generate，您可以使用以下命令安装它：

cargo install cargo-generate

Icon InfoCircle

注意 您可以通过访问其 存储库 Icon Link 了解有关 cargo generate 的更多信息。

让我们使用以下命令生成默认的测试框架：

cargo generate --init fuellabs/sway templates/sway-test-rs --name <Project name> --force

--force 强制您的 --name 输入保留您在模板中的 {{project-name}} 占位符的所需大小写。否则，cargo-generate 会自动将其转换为 kebab-case。使用 --force，这意味着 my_fuel_project 和 my-fuel-project 都是有效的项目名称，具体取决于您的需求。

在运行测试之前，我们需要使用以下命令构建 Sway 项目：

forc build

然后，我们可以使用以下命令运行测试：

cargo test

Icon InfoCircle

注意 如果您需要捕获测试的输出，请使用以下命令之一：

cargo test -- --nocapture

Icon Link导入 Fuel Rust SDK

在您的 Cargo.toml 中添加以下依赖项：

fuels = "0.63.0"

Icon InfoCircle

注意 我们使用版本 0.63.0 的 SDK，在撰写本文时为最新版本。

然后，在您将使用 SDK 的 Rust 文件中：

use fuels::prelude::*;

Icon LinkFuel Rust SDK 源代码

体验 SDK 的另一种方式是查看源代码。 e2e/tests/ 文件夹中充满了涵盖 SDK 几乎所有方面的集成测试。

Icon InfoCircle

注意 在运行测试之前，我们需要构建所有 Sway 测试项目。文件 packages/fuels/Forc.toml 包含一个 [workspace]，其成员是所有集成测试的路径。 要构建这些测试，请运行以下命令：

forc build --release --path packages/fuels

Icon InfoCircle

forc 也可用于清理和格式化测试项目。查看 help 输出以获取更多信息。

构建项目后，我们可以使用以下命令运行测试

cargo test

如果您需要所有目标和所有功能，则可以运行

cargo test --all-targets --all-features

Icon InfoCircle

注意 如果您需要捕获测试的输出，您可以运行

cargo test -- --nocapture

Icon Link更深入的 Fuel 和 Sway 知识

阅读 Sway 书籍 Icon Link 获取有关 Sway 的更深入知识，Sway 是 Fuel 虚拟机的官方智能合约语言。