Um guia para configurar o seu ambiente de desenvolvimento local Solana. Aprenda a instalar Rust, a CLI Solana e o Anchor Framework no Windows (WSL), Linux e Mac. Use este guia se preferir instalar cada dependência individualmente, ou se a instalação rápida falhar por qualquer motivo.
Pré-requisitos
Instalar o Rust
Os desenvolvedores criam programas Solana usando a linguagem de programação Rust.
- Instale o Rust usando rustup digitando o seguinte comando no seu terminal:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Após uma instalação bem-sucedida, você verá a seguinte mensagem:
- Recarregue a sua variável de ambiente PATH para incluir o diretório bin do Cargo:
$. "$HOME/.cargo/env"
- Verifique se a instalação foi bem-sucedida.
$rustc --version
Você verá uma saída como a seguinte:
rustc 1.86.0 (05f9846f8 2025-03-31)
Instalar Solana CLI
A Solana CLI fornece todas as ferramentas necessárias para construir e implementar programas Solana.
- Instale o conjunto de ferramentas Solana CLI usando o comando de instalação oficial:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Você pode substituir stable pela etiqueta de lançamento correspondente à
versão do software do seu lançamento desejado (por exemplo, v2.0.3), ou usar
um dos três nomes de canal simbólicos: stable, beta, ou edge.
- Adicione uma variável de ambiente PATH
Uma instalação inicial da Solana CLI pode solicitar que você adicione uma
variável de ambiente PATH. Para fazer isso, feche e reabra o seu terminal ou
execute o seguinte no seu shell:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Atualize a sua variável de ambiente PATH
Se você estiver a usar Linux ou WSL, deve adicionar o binário da Solana CLI ao seu PATH para que o comando esteja disponível no seu terminal. Para fazer isso, siga os passos abaixo:
a. Verifique qual shell você está a usar:
$echo $SHELL
- Se a saída contiver
/bash, use.bashrc. - Se a saída contiver
/zsh, use.zshrc.
b. Execute o comando apropriado, com base no seu shell.
Para Bash (bashrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Para Zsh (zshrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Reinicie o seu terminal ou execute o seguinte comando para atualizar a sessão do terminal:
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Verifique se a instalação foi bem-sucedida verificando a versão do Solana CLI:
$solana --version
Você verá uma saída como a seguinte:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Você pode visualizar todas as versões disponíveis no repositório Github do Agave. Agave é o cliente validator da Anza, anteriormente conhecido como cliente validator do Solana Labs.
- Atualize o Solana CLI para a versão mais recente, conforme necessário (Opcional)
$agave-install update
Instalar Anchor CLI
Anchor é uma framework para desenvolver programas Solana. A framework Anchor utiliza macros Rust para simplificar o processo de escrever programas Solana.
Pré-requisitos
O ficheiro de teste padrão do projeto Anchor (TypeScript) criado com o comando
anchor init requer Node.js e Yarn. (O modelo de teste Rust está
disponível usando anchor init --test-template rust)
Instalação
Você pode instalar a CLI e as ferramentas do Anchor de duas formas:
- Anchor Version Manager (AVM) — Método de instalação recomendado
- Sem AVM — Instalar diretamente do GitHub
O Anchor Version Manager (AVM) permite instalar e gerir diferentes versões do Anchor no seu sistema e atualizar facilmente as versões do Anchor no futuro. Para instalar o Anchor usando o AVM, siga os passos abaixo:
- Instale o AVM com o seguinte comando:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Confirme que o AVM foi instalado com sucesso:
$avm --version
- Instale o Anchor CLI usando o AVM:
Para instalar a versão mais recente:
$avm install latest$avm use latest
Para instalar uma versão específica, especifique o número da versão:
$avm install 0.30.1$avm use 0.30.1
Ao instalar o Anchor CLI no Linux ou WSL, poderá encontrar este erro:
error: could not exec the linker cc = note: Permission denied (os error 13)
Se vir esta mensagem de erro, siga estes passos:
- Instale as dependências listadas na secção Linux no topo desta página.
- Tente novamente instalar o Anchor CLI.
- Verifique se a instalação foi bem-sucedida, verificando a versão do Anchor CLI:
$anchor --version
Você verá uma saída como a seguinte:
anchor-cli 0.31.1
Não se esqueça de executar o comando avm use para declarar a versão do
Anchor CLI a executar no seu sistema.
- Se instalou a versão
latest, executeavm use latest. - Se instalou a versão
0.30.1, executeavm use 0.30.1.
Instalar Surfpool CLI
Surfpool é uma ferramenta para desenvolvimento local e
uma substituição aprimorada para solana-test-validator. Saiba mais sobre os
recursos do Surfpool na documentação do Surfpool.
- Instale o Surfpool com o seguinte comando:
$curl -sL https://run.surfpool.run/ | bash
- Verifique se a instalação foi bem-sucedida verificando a versão do Surfpool CLI:
$surfpool --version
Você verá uma saída como a seguinte:
surfpool 0.12.0
Configurar ferramentas de IA para desenvolvimento Solana
Esta secção detalha a configuração opcional de ferramentas de IA que pode usar para acelerar o seu desenvolvimento Solana.
| Ferramenta | Descrição | Ligação |
|---|---|---|
| MCP | Servidor MCP ao qual pode conectar-se com o cursor para melhorar o desenvolvimento Solana assistido por IA. | https://mcp.solana.com/ |
| LLMs.txt | Documentação otimizada para LLM que pode usar para treinar LLMs na documentação Solana. | https://solana.com/llms.txt |
Is this page helpful?