安装

Icon Link工具链安装

本指南将帮助你安装 Fuel 工具链的二进制文件和必要的前提条件。

本指南涵盖以下主题:

  1. 使用 fuelup 安装 Fuel 工具链
  2. 更改默认工具链
  3. 设置本地钱包
  4. 安装 Rust

Icon Link使用 fuelup 安装 Fuel 工具链

fuelup 是 Fuel 的官方包管理器,可以从官方发布渠道安装 Fuel 工具链,使你可以轻松地在不同工具链之间切换并保持更新。它使使用 forc fuel-core Icon Link 在常见平台上构建和维护 Sway 应用程序变得更简单。

Icon InfoCircle

💡 欲了解更多信息,请查看 fuelup 文档 Icon Link

Icon Link运行 fuelup-init

要安装 Fuel 工具链,你可以使用 fuelup-init 脚本。 这将安装 forcforc-clientforc-fmtforc-lspforc-wallet 以及 fuel-core~/.fuelup/bin

👉 只需在终端中粘贴以下行并按 Enter

curl https://install.fuel.network | sh
Icon InfoCircle

🚧 请注意,目前我们尚不支持 Windows 的本机安装。如果你希望在 Windows 上使用 fuelup,请使用 Windows Subsystem for Linux。

Icon Link设置 PATH

脚本下载后,将自动执行。 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。

Icon Link检查安装

允许 fuelup-init 脚本修改你的 PATH 变量后,你会看到很多关于包下载和安装的信息。如果一切顺利,你将看到以下消息:

Icon Link检查安装情况

在允许 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

Icon LinkVSCode 扩展

如果您正在使用 VSCode,我们建议安装 Sway 扩展 Icon Link

Icon Link更改默认工具链

就像在 Rust Icon Link 中一样,Fuel 支持多个工具链。 工具链是一组工具(如编译器、LSP 等)。 默认情况下,`fuelup` 包含了一系列经过测试以相互配合使用的软件包,提供了可靠的工具集。 默认情况下,安装 fuelup 时配置的是 latest 工具链,这是与当前 testnet 网络兼容的稳定工具链。

Icon Link更新 fuelup

确保您拥有 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

Icon Link使用最新工具链

为了正确地与测试网络进行交互,必须使用 latest 工具链,默认已安装。

👉 运行以下命令验证 latest 工具链的安装:

fuelup show

如果工具链安装成功,您将看到以下输出:

installed toolchains
--------------------
latest-x86_64-unknown-linux-gnu (default)

active toolchain
-----------------
latest-x86_64-unknown-linux-gnu (default)
...

Icon Link安装 nightly 工具链

如果您想尝试 Fuel 工具链的未发布功能,可以安装 nightly 工具链。

👉 运行以下命令安装 nightly 工具链:

fuelup toolchain install nightly

如果工具链安装成功,您将看到以下输出:

The Fuel toolchain is installed and up to date

工具链已正确安装,但尚未启用。接下来,你需要配置 fuelupnightly 工具链设置为默认工具链。

👉 使用以下命令将 nightly 设置为默认工具链:

fuelup default nightly 

你将看到以下输出,表示已成功将 nightly 设置为默认工具链。

default toolchain set to nightly

Icon Link检查当前工具链

有时你可能会同时使用多个工具链。 不要担心,如果你对正在使用的工具链感到困惑,可以随时检查你的当前工具链。

👉 运行 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

Icon Link设置本地钱包

forc-wallet 插件随默认分发的工具链一起打包安装,因此如果你按照上述说明操作,应该已经安装了它。

要使用 forc-wallet 初始化一个新钱包,可以运行以下命令:

forc wallet new

输入密码后,务必保存输出的助记词。

接下来,创建一个新的钱包账户:

forc wallet account new

这样,你将获得一个类似于这样的 Fuel 地址:fuel1efz7lf36w9da9jekqzyuzqsfrqrlzwtt3j3clvemm6eru8fe9nvqj5kar8

如果你需要列出你的账户,可以运行以下命令:

forc wallet accounts

Icon Link安装 Rust

如果你想使用 fuels Rust SDK 开发,你需要在你的机器上安装 Rust。要安装 Rust,你可以使用 rustup 工具。

Icon InfoCircle

如果你不打算使用 Rust SDK,则无需安装 Rust。

在你的 shell 中运行以下命令;这将下载并运行 rustup-init.sh,进而下载并运行适合你平台的 rustup-init 可执行文件。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

查看官方 Rust 文档以获取有关 安装 Rust 工具链 Icon Link 的更多信息。

Icon Link接下来做什么?

现在你已经准备好开始使用 Fuel 进行构建。

👉 查看 counter dapp 指南 部署你的第一个智能合约。

Icon Link超越基础

Icon Link自定义工具链

你可以创建一组特定版本的工具链,这称为“自定义工具链”。

👉 访问 Fuelup 文档 Icon Link 学习如何设置自定义工具链。

Icon Link从源代码构建

你可以随时从源代码构建 Fuel 包。

👉 访问 Fuelup 文档 Icon Link 获取有关其他安装类型的更多详细信息。

Icon LinkGithub Codespaces

你始终可以在浏览器中运行开发环境。

👉 访问我们的 Github Codespaces 指南 在浏览器中使用 Fuel 工具链。