Foundry 安装

本章介绍 Foundry 的安装和使用方法。

安装和使用 Foundry 有 4 种方式：使用二进制文件安装、使用 Foundryup安装、使用源代码构建，以及使用 docker。

Foundry 并没有独立的官网，获取它的安装文件或者源码，都可以通过它的官方 github 地址。

1.  二进制文件安装

可以从 GitHub 发布页面 获取预编译的二进制文件， 它的地址为：https://github.com/foundry-rs/foundry/releases。

Foundry 发布的二进制安装文件，支持 Windows、Linux、MacOS 系统。我们可以选择适合自己操作系统的版本。

这些二进制安装包解压后，都会释放4个文件： forge、cast、anvil 和 chisel。

直接下载预编译的二进制文件，是我们推荐的安装方式。如果使用其它方式安装，将会碰到科学上网引起的诸多问题。

解压后的4个文件在命令行中可以直接使用，Foundry 就是通过运行命令来编译和测试合约的，无需进一步安装。

建议将这4个文件所在的目录，加入到环境变量 Path 中，这样就可以在任意目录下使用它们了。

另外，通常 Foundry 与 Vscode 配套使用，Vscode 用来编写合约，执行编译和测试工作。Vscode 是微软的免费软件，请自行安装学习。

2. 使用 Foundryup 安装

Foundryup 是 Foundry 工具链的安装程序，使用 Foundryup 安装，也是一种常用的安装方式。

使用 Foundryup 可以更好地管理这些工具，比如可以及时地对它们进行升级。

打开终端并运行以下命令：

curl -L https://foundry.paradigm.xyz | bash

这将安装 Foundryup。

然后在 CLI 中运行 Foundryup ，就会安装最新的预编译二进制文件: forge、cast、anvil 和 chisel。

注意：如果您使用 Windows，您需要安装并使用 Git BASH 或 WSL 作为您的终端，因为 Foundryup 目前不支持 Powershell 或 Cmd。

3. 使用源代码构建

使用源代码构建，首先需要安装 Rust 编译器和 Cargo。

安装两者的最简单方法是使用 rustup.rs。 Foundry 通常仅支持在最新的稳定 Rust 版本上构建。

如果您使用较旧的 Rust 版本，可以使用 rustup 进行更新：

rustup update stable

在 Windows 上，您还需要安装带有 “使用 C++进行桌面开发” 选项的最新版本的 Visual Studio。

构建命令：

foundryup --branch master
foundryup --path path/to/foundry

或者，使用单个 Cargo 命令：

cargo install --git https://github.com/foundry-rs/foundry --profile local --locked forge cast chisel anvil

或者，通过手动从 Foundry 存储库的本地副本构建：

# clone the repository
git clone https://github.com/foundry-rs/foundry.git
cd foundry
# install Forge
cargo install --path ./crates/forge --profile local --force --locked
# install Cast
cargo install --path ./crates/cast --profile local --force --locked
# install Anvil
cargo install --path ./crates/anvil --profile local --force --locked
# install Chisel
cargo install --path ./crates/chisel --profile local --force --locked

4. 使用 Docker

Foundry 也可以完全在 docker 容器中使用。如果您没有安装 docker，可以直接从 docker 网站安装。

安装后，可以通过运行以下命令下载最新版本：

docker pull ghcr.io/foundry-rs/foundry:latest

也可以在本地构建 docker 镜像。从 Foundry 存储库运行：

docker build -t foundry .