Instalar Dependências
Um guia para configurar seu ambiente de desenvolvimento local Solana. Aprenda como instalar Rust, a CLI do Solana e o Framework Anchor 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 Rust
Os desenvolvedores constroem programas Solana usando a linguagem de programação Rust.
- Instale o Rust usando rustup digitando o seguinte comando no seu terminal:
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 sua variável de ambiente PATH para incluir o diretório bin do Cargo:
Terminal
$. "$HOME/.cargo/env"
- Verifique se a instalação foi bem-sucedida.
Terminal
$rustc --version
Você verá uma saída como a seguinte:
rustc 1.86.0 (05f9846f8 2025-03-31)
Instalar a CLI da Solana
A CLI da Solana fornece todas as ferramentas necessárias para construir e implantar programas Solana.
- Instale o conjunto de ferramentas da CLI da Solana usando o comando de instalação oficial:
Terminal
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Você pode substituir stable pela tag de lançamento correspondente à versão
do software da sua versão desejada (por exemplo, v2.0.3), ou usar um dos
três nomes simbólicos de canal: stable, beta ou edge.
- Adicione uma variável de ambiente PATH
Uma instalação inicial da CLI da Solana pode solicitar que você adicione uma
variável de ambiente PATH. Para fazer isso, feche e reabra seu terminal ou
execute o seguinte no seu shell:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Atualize sua variável de ambiente PATH
Se você estiver usando Linux ou WSL, deve adicionar o binário da CLI da Solana 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á usando:
Terminal
$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):
Terminal
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Para Zsh (zshrc):
Terminal
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Reinicie seu terminal ou execute o seguinte comando para atualizar a sessão do terminal:
Terminal
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Verifique se a instalação foi bem-sucedida verificando a versão da CLI Solana:
Terminal
$solana --version
Você verá uma saída como a seguinte:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Você pode ver todas as versões disponíveis no repositório Github do Agave. Agave é o cliente validator da Anza, anteriormente conhecido como cliente validator Solana Labs.
- Atualize a CLI Solana para a versão mais recente, conforme necessário (Opcional)
Terminal
$agave-install update
Instalar Anchor CLI
Anchor é um framework para desenvolver programas na Solana. O framework Anchor utiliza macros Rust para simplificar o processo de escrita de programas Solana.
Pré-requisitos
O arquivo de teste padrão do projeto Anchor (TypeScript) criado com o comando
anchor init requer Node.js e Yarn. (O modelo de teste em Rust está
disponível usando anchor init --test-template rust)
Instalação
Você pode instalar a CLI e as ferramentas do Anchor de duas maneiras:
- Anchor Version Manager (AVM) — Método de instalação recomendado
- Sem AVM — Instalar diretamente do GitHub
O Anchor Version Manager (AVM) permite que você instale e gerencie diferentes versões do Anchor em seu sistema e atualize 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:
Terminal
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Confirme que o AVM foi instalado com sucesso:
Terminal
$avm --version
- Instale o Anchor CLI usando o AVM:
Para instalar a versão mais recente:
Terminal
$avm install latest$avm use latest
Para instalar uma versão específica, especifique o número da versão:
Terminal
$avm install 0.30.1$avm use 0.30.1
Ao instalar o Anchor CLI no Linux ou WSL, você pode encontrar este erro:
error: could not exec the linker cc = note: Permission denied (os error 13)
Se você ver esta mensagem de erro, siga estes passos:
- Instale as dependências listadas na seção Linux no topo desta página.
- Tente instalar o Anchor CLI novamente.
- Verifique se a instalação foi bem-sucedida, verificando a versão do Anchor CLI:
Terminal
$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 ser executada em seu sistema.
- Se você instalou a versão
latest, executeavm use latest. - Se você instalou a versão
0.30.1, executeavm use 0.30.1.
Configurando ferramentas de IA para desenvolvimento Solana
Esta seção detalha a configuração opcional de ferramentas de IA que você pode usar para acelerar seu desenvolvimento Solana.
| Ferramenta | Descrição | Link |
|---|---|---|
| MCP | Servidor MCP ao qual você pode se conectar com o cursor para melhorar o desenvolvimento assistido por IA da Solana. | https://mcp.solana.com/ |
| LLMs.txt | Documentação otimizada para LLM que você pode usar para treinar LLMs na documentação da Solana. | https://solana.com/llms.txt |
Is this page helpful?