Installer les dépendances
Un guide pour configurer votre environnement de développement Solana local. Apprenez à installer Rust, la CLI Solana et le framework Anchor sur Windows (WSL), Linux et Mac. Utilisez ce guide si vous préférez installer chaque dépendance individuellement, ou si l'installation rapide échoue pour une raison quelconque.
Prérequis
Installer Rust
Les développeurs créent des programmes Solana en utilisant le langage de programmation Rust.
- Installez Rust en utilisant rustup en saisissant la commande suivante dans votre terminal :
Terminal
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Après une installation réussie, vous verrez le message suivant :
- Rechargez votre variable d'environnement PATH pour inclure le répertoire bin de Cargo :
Terminal
$. "$HOME/.cargo/env"
- Vérifiez que l'installation a réussi.
Terminal
$rustc --version
Vous verrez une sortie comme celle-ci :
rustc 1.86.0 (05f9846f8 2025-03-31)
Installer Solana CLI
Solana CLI fournit tous les outils nécessaires pour créer et déployer des programmes Solana.
- Installez la suite d'outils Solana CLI en utilisant la commande d'installation officielle :
Terminal
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Vous pouvez remplacer stable par le tag de version correspondant à la
version du logiciel de votre version souhaitée (par exemple v2.0.3), ou
utiliser l'un des trois noms de canaux symboliques : stable, beta, ou
edge.
- Ajoutez une variable d'environnement PATH
Une première installation de Solana CLI peut vous inviter à ajouter une variable
d'environnement PATH. Pour ce faire, fermez et rouvrez votre terminal ou
exécutez la commande suivante dans votre shell :
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Mettez à jour votre variable d'environnement PATH
Si vous utilisez Linux ou WSL, vous devez ajouter le binaire Solana CLI à votre PATH pour que la commande soit disponible dans votre terminal. Pour ce faire, suivez les étapes ci-dessous :
a. Vérifiez quel shell vous utilisez :
Terminal
$echo $SHELL
- Si la sortie contient
/bash, utilisez.bashrc. - Si la sortie contient
/zsh, utilisez.zshrc.
b. Exécutez la commande appropriée, selon votre shell.
Pour Bash (bashrc) :
Terminal
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Pour Zsh (zshrc) :
Terminal
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Redémarrez votre terminal ou exécutez la commande suivante pour actualiser la session du terminal :
Terminal
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Vérifiez que l'installation a réussi en vérifiant la version de la CLI Solana :
Terminal
$solana --version
Vous verrez une sortie comme celle-ci :
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Vous pouvez consulter toutes les versions disponibles sur le dépôt Github Agave. Agave est le client validator d'Anza, anciennement connu sous le nom de client validator Solana Labs.
- Mettez à jour la CLI Solana vers la dernière version, si nécessaire (Facultatif)
Terminal
$agave-install update
Installer la CLI Anchor
Anchor est un framework pour développer des programmes Solana. Le framework Anchor utilise des macros Rust pour simplifier le processus d'écriture des programmes Solana.
Prérequis
Le fichier de test par défaut du projet Anchor (TypeScript) créé avec la
commande anchor init nécessite Node.js et Yarn. (Le modèle de test Rust
est disponible en utilisant anchor init --test-template rust)
Installation
Vous pouvez installer l'interface en ligne de commande (CLI) Anchor et les outils de deux façons :
- Anchor Version Manager (AVM) — Méthode d'installation recommandée
- Sans AVM — Installation directe depuis GitHub
Le gestionnaire de versions d'Anchor (AVM) vous permet d'installer et de gérer différentes versions d'Anchor sur votre système et de mettre à jour facilement les versions d'Anchor à l'avenir. Pour installer Anchor en utilisant AVM, suivez les étapes ci-dessous :
- Installez AVM avec la commande suivante :
Terminal
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Confirmez que l'installation d'AVM a réussi :
Terminal
$avm --version
- Installez l'interface de ligne de commande (CLI) Anchor en utilisant AVM :
Pour installer la dernière version :
Terminal
$avm install latest$avm use latest
Pour installer une version spécifique, précisez le numéro de version :
Terminal
$avm install 0.30.1$avm use 0.30.1
Lors de l'installation du CLI Anchor sur Linux ou WSL, vous pourriez rencontrer cette erreur :
error: could not exec the linker cc = note: Permission denied (os error 13)
Si vous voyez ce message d'erreur, suivez ces étapes :
- Installez les dépendances listées dans la section Linux en haut de cette page.
- Réessayez d'installer le CLI Anchor.
- Vérifiez que l'installation a réussi en contrôlant la version du CLI Anchor :
Terminal
$anchor --version
Vous verrez une sortie comme celle-ci :
anchor-cli 0.31.1
N'oubliez pas d'exécuter la commande avm use pour déclarer la version
du CLI Anchor à utiliser sur votre système.
- Si vous avez installé la version
latest, exécutezavm use latest. - Si vous avez installé la version
0.30.1, exécutezavm use 0.30.1.
Configuration des outils d'IA pour le développement Solana
Cette section détaille la configuration optionnelle des outils d'IA que vous pouvez utiliser pour accélérer votre développement Solana.
| Outil | Description | Lien |
|---|---|---|
| MCP | Serveur MCP auquel vous pouvez vous connecter avec cursor pour améliorer le développement Solana assisté par IA. | https://mcp.solana.com/ |
| LLMs.txt | Documentation optimisée pour les LLM que vous pouvez utiliser pour entraîner les LLM sur la documentation Solana. | https://solana.com/llms.txt |
Is this page helpful?