Noções básicas da CLI do Anchor

Esta seção fornece alguns comandos e exemplos comuns para ajudá-lo a começar a usar a CLI do Anchor.

Inicializar o projeto

Crie um novo projeto Anchor executando o comando mostrado abaixo. Ele criará um novo diretório com o nome do projeto e o usará para inicializar um novo projeto Anchor.

Terminal
$
anchor init <project-name>

Por exemplo, o comando abaixo criará um projeto chamado my-project. O diretório my-project conterá um programa Rust modular e um modelo de testes em Rust que usa o LiteSVM.

Terminal
$
anchor init my-project

Para gerar um modelo de testes em TypeScript, escolha um explicitamente. Por exemplo, use o modelo Mocha:

Terminal
$
anchor init my-project --test-template mocha

Os modelos de testes em TypeScript exigem o Node.js e um gerenciador de pacotes JavaScript.

Em seguida, acesse o diretório do projeto:

Terminal
$
cd <project-name>

Consulte a estrutura de arquivos de projeto do Anchor.

Compilar o programa

Para compilar seu projeto, execute o seguinte comando:

Terminal
$
anchor build

Você pode encontrar o programa compilado no diretório /target/deploy.

Falha ao instalar as ferramentas da plataforma

Se a compilação informar um diretório platform-tools inválido, reinstale as ferramentas de compilação SBF e tente compilar novamente:

Terminal
$
cargo build-sbf --force-tools-install
$
anchor build

Implantar o programa

Para implantar seu projeto, execute o seguinte comando:

Terminal
$
anchor deploy

Este comando implanta seu programa no cluster especificado no arquivo Anchor.toml.

Testar o programa

Para testar seu projeto, execute o seguinte comando:

Terminal
$
anchor test

Este comando compila, implanta e executa os testes do seu projeto.

Ao usar o cluster localnet, o Anchor inicia automaticamente um validador local, implanta o programa, executa os testes e depois para o validador.

Erros do executor de testes JavaScript

Se você selecionou um modelo de testes em JavaScript ou TypeScript, qualquer um dos seguintes erros pode indicar que o Node.js ou o gerenciador de pacotes configurado não está instalado:

Permission denied (os error 13)
No such file or directory (os error 2)

Is this page helpful?

Índice

Editar Página
© 2026 Fundação Solana. Todos os direitos reservados.