本指南将帮助你安装 Fuel 工具链的二进制文件和必要的前提条件。
本指南涵盖以下主题:
fuelup
安装 Fuel 工具链 fuelup
是 Fuel 的官方包管理器,可以从官方发布渠道安装 Fuel 工具链,使你可以轻松地在不同工具链之间切换并保持更新。它使使用 forc
和 fuel-core
在常见平台上构建和维护 Sway 应用程序变得更简单。
💡 欲了解更多信息,请查看 fuelup 文档 。
fuelup-init
要安装 Fuel 工具链,你可以使用 fuelup-init
脚本。
这将安装 forc
、forc-client
、forc-fmt
、forc-lsp
、forc-wallet
以及 fuel-core
到 ~/.fuelup/bin
。
👉 只需在终端中粘贴以下行并按 Enter。
curl https://install.fuel.network | sh
🚧 请注意,目前我们尚不支持 Windows 的本机安装。如果你希望在 Windows 上使用
fuelup
,请使用 Windows Subsystem for Linux。
脚本下载后,将自动执行。
fuelup-init
脚本会提示你以下问题:
fuelup uses "/home/username/.fuelup" as its home directory to manage the Fuel toolchain, and will install binaries there.
To use the toolchain, you will have to configure your PATH, which tells your machine where to locate `fuelup` and the Fuel toolchain.
If permitted, fuelup-init will configure your PATH for you by running the following:
echo "export PATH="$HOME/.fuelup/bin:$PATH"" >> /home/username/.bashrc
Would you like fuelup-init to modify your PATH variable for you? (N/y)
👉 在终端中按 Y
键并按 Enter 以修改你的 PATH。
允许 fuelup-init
脚本修改你的 PATH
变量后,你会看到很多关于包下载和安装的信息。如果一切顺利,你将看到以下消息:
在允许 fuelup-init
脚本修改您的 PATH
变量后,您将看到大量有关正在下载和安装的软件包的信息。 如果一切正常,您将看到以下消息:
The Fuel toolchain is installed and up to date
fuelup 0.20.0 has been installed in /home/username/.fuelup/bin.
To fetch the latest toolchain containing the forc and fuel-core binaries, run 'fuelup toolchain install latest'.
To generate completions for your shell, run 'fuelup completions --shell=SHELL'.
👉 随时使用 `fuelup --version` 命令查看您正在使用的软件包的版本。
fuelup --version
这将输出您当前的 `fuelup` 版本:
fuelup 0.21.0
如果您正在使用 VSCode,我们建议安装 Sway 扩展 。
就像在 Rust 中一样,Fuel 支持多个工具链。
工具链是一组工具(如编译器、LSP 等)。
默认情况下,`fuelup` 包含了一系列经过测试以相互配合使用的软件包,提供了可靠的工具集。
默认情况下,安装 fuelup
时配置的是 latest
工具链,这是与当前 testnet
网络兼容的稳定工具链。
确保您拥有 fuelup
的最新版本,以便您可以访问最新功能并获得最佳性能。
👉 运行以下命令更新 fuelup
:
fuelup self update
然后您将获得如下输出:
Fetching binary from https://github.com/FuelLabs/fuelup/releases/download/v0.19.5/fuelup-0.19.5-aarch64-apple-darwin.tar.gz
Downloading component fuelup without verifying checksum
Unpacking and moving fuelup to /var/folders/tp/0l8zdx9j4s9_n609ykwxl0qw0000gn/T/.tmpiNJQHt
Moving /var/folders/tp/0l8zdx9j4s9_n609ykwxl0qw0000gn/T/.tmpiNJQHt/fuelup to /Users/.fuelup/bin/fuelup
为了正确地与测试网络进行交互,必须使用 latest
工具链,默认已安装。
👉 运行以下命令验证 latest
工具链的安装:
fuelup show
如果工具链安装成功,您将看到以下输出:
installed toolchains
--------------------
latest-x86_64-unknown-linux-gnu (default)
active toolchain
-----------------
latest-x86_64-unknown-linux-gnu (default)
...
nightly
工具链 如果您想尝试 Fuel 工具链的未发布功能,可以安装 nightly
工具链。
👉 运行以下命令安装 nightly
工具链:
fuelup toolchain install nightly
如果工具链安装成功,您将看到以下输出:
The Fuel toolchain is installed and up to date
工具链已正确安装,但尚未启用。接下来,你需要配置 fuelup
将 nightly
工具链设置为默认工具链。
👉 使用以下命令将 nightly
设置为默认工具链:
fuelup default nightly
你将看到以下输出,表示已成功将 nightly
设置为默认工具链。
default toolchain set to nightly
有时你可能会同时使用多个工具链。 不要担心,如果你对正在使用的工具链感到困惑,可以随时检查你的当前工具链。
👉 运行 fuelup show
命令查看你正在使用的工具链及各工具的版本。
fuelup show
此命令将给出以下输出
active toolchain
-----------------
beta-4-x86_64-unknown-linux-gnu (default)
forc : 0.45.0
- forc-client
- forc-deploy : 0.45.0
- forc-run : 0.45.0
- forc-doc : 0.45.0
- forc-explore : 0.28.1
- forc-fmt : 0.45.0
- forc-index : 0.20.7
- forc-lsp : 0.45.0
- forc-tx : 0.45.0
- forc-wallet : 0.3.0
fuel-core : 0.20.4
fuel-core-keygen : Error getting version string
fuels versions
---------------
forc : 0.45
forc-wallet : 0.45
forc-wallet
插件随默认分发的工具链一起打包安装,因此如果你按照上述说明操作,应该已经安装了它。
要使用 forc-wallet
初始化一个新钱包,可以运行以下命令:
forc wallet new
输入密码后,务必保存输出的助记词。
接下来,创建一个新的钱包账户:
forc wallet account new
这样,你将获得一个类似于这样的 Fuel 地址:fuel1efz7lf36w9da9jekqzyuzqsfrqrlzwtt3j3clvemm6eru8fe9nvqj5kar8
。
如果你需要列出你的账户,可以运行以下命令:
forc wallet accounts
如果你想使用 fuels
Rust SDK 开发,你需要在你的机器上安装 Rust。要安装 Rust,你可以使用 rustup
工具。
如果你不打算使用 Rust SDK,则无需安装 Rust。
在你的 shell 中运行以下命令;这将下载并运行 rustup-init.sh
,进而下载并运行适合你平台的 rustup-init
可执行文件。
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
查看官方 Rust 文档以获取有关 安装 Rust 工具链 的更多信息。
现在你已经准备好开始使用 Fuel 进行构建。
👉 查看 counter dapp 指南 部署你的第一个智能合约。
你可以创建一组特定版本的工具链,这称为“自定义工具链”。
👉 访问 Fuelup 文档 学习如何设置自定义工具链。
你可以随时从源代码构建 Fuel 包。
👉 访问 Fuelup 文档 获取有关其他安装类型的更多详细信息。
你始终可以在浏览器中运行开发环境。
👉 访问我们的 Github Codespaces 指南 在浏览器中使用 Fuel 工具链。