本地开发

创建一个新项目

要启动一个新项目，请使用 anchor init 命令，后跟你的项目名称。此命令将创建一个具有指定名称的新目录，并设置默认的程序和测试文件。

anchor init my-program

导航到新项目目录并在代码编辑器中打开它。

cd my-project

默认的 Anchor 程序位于 /programs/my-project/src/lib.rs。

默认的 Typescript 测试文件位于 /tests/my-project.ts。

如果你更喜欢使用 Rust 进行测试，可以使用 --test-template rust (Anchor Rust 客户端) 或 --test-template mollusk (Mollusk 测试库) 标志初始化你的项目。

anchor init --test-template rust my-program

Rust 测试文件将位于 /tests/src/test_initialize.rs。

构建程序

通过运行 anchor build 来构建程序。

anchor build

编译后的程序将位于 /target/deploy/my_project.so。当你部署程序时，此文件的内容将被存储到 Solana 网络上（作为一个可执行账户）。

测试程序

要测试程序，请运行 anchor test。

anchor test

默认情况下，Anchor.toml 配置文件指定了 localnet 集群。在 localnet 上开发时，anchor test 将自动：

1. 启动一个本地 Solana 验证器
2. 构建并将你的程序部署到本地集群
3. 运行 tests 文件夹中的测试
4. 停止本地 Solana 验证器

或者，你可以手动启动一个本地 Solana 验证器并对其进行测试。这对于你在迭代程序时希望保持验证器运行很有用。它允许你在开发时在 Solana Explorer 上检查账户和交易日志。

打开一个新终端并通过运行 solana-test-validator 命令启动一个本地 Solana 验证器。

solana-test-validator

在另一个终端中，针对本地集群运行测试。使用 --skip-local-validator 标志跳过启动本地验证器，因为它已经在运行。

anchor test --skip-local-validator

部署到 Devnet

默认情况下，Anchor 项目中的 Anchor.toml 配置文件指定了 localnet 集群。

[toolchain]
 
[features]
resolution = true
skip-lint = false
 
[programs.localnet]
my_program = "3ynNB373Q3VAzKp7m4x238po36hjAGFXFJB4ybN2iTyg"
 
[registry]
url = "https://api.apr.dev"
 
[provider]
cluster = "Localnet"
wallet = "~/.config/solana/id.json"
 
[scripts]
test = "yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/**/*.ts"

要将你的程序部署到 devnet，请将 cluster 值更改为 Devnet。

-cluster = "Localnet"
+cluster = "Devnet"

[provider]
cluster = "Devnet"
wallet = "~/.config/solana/id.json"

现在，当你运行 anchor deploy 时，你的程序将被部署到 devnet 集群。anchor test 命令也将使用 Anchor.toml 文件中指定的集群。

anchor deploy

要部署到主网，只需更新 Anchor.toml 文件以指定主网集群。

[provider]
cluster = "Mainnet"
wallet = "~/.config/solana/id.json"

更新程序

Solana 程序可以通过将程序重新部署到相同的程序 ID 来更新。

要更新程序，只需对你的程序代码进行更改，并运行 anchor build 命令以生成更新的 .so 文件。

anchor build

然后运行 anchor deploy 命令以重新部署更新的程序。

anchor deploy

关闭程序

要回收分配给程序账户的 SOL，你可以关闭你的 Solana 程序。

要关闭程序，请使用 solana program close <PROGRAM_ID> 命令。例如：

solana program close 3ynNB373Q3VAzKp7m4x238po36hjAGFXFJB4ybN2iTyg --bypass-warning

请注意，一旦程序关闭，程序 ID 将不能用于部署新程序。