Installation
Cette section couvre les étapes pour configurer votre environnement local pour le développement Solana.
Installation rapide
Sur Mac et Linux, exécutez cette commande unique pour installer toutes les dépendances.
$curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash
Utilisateurs Windows : vous devez d'abord installer WSL (voir Installer les dépendances). Ensuite, exécutez la commande précédente dans le terminal Ubuntu (Linux).
Après l'installation, vous devriez voir une sortie comme celle-ci :
Installed Versions:Rust: rustc 1.86.0 (05f9846f8 2025-03-31)Solana CLI: solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)Anchor CLI: anchor-cli 0.31.1Node.js: v23.11.0Yarn: 1.22.1
Si la commande d'installation rapide ne fonctionne pas, veuillez vous référer à la section Installer les dépendances ci-dessous pour les instructions d'installation individuelle de chaque dépendance.
Si la commande d'installation rapide s'exécute avec succès, passez aux sections Bases de la CLI Solana et Bases de la CLI Anchor ci-dessous.
Installer les dépendances
Les instructions ci-dessous vous guident à travers l'installation individuelle de chaque dépendance.
- Les utilisateurs Windows doivent d'abord installer WSL (sous-système Windows pour Linux) puis installer les dépendances spécifiées dans la section Linux ci-dessous.
- Les utilisateurs Linux doivent d'abord installer les dépendances spécifiées dans la section Linux ci-dessous.
- Les utilisateurs Mac doivent commencer par les instructions d'installation de Rust ci-dessous.
Installer Rust
Les développeurs construisent des programmes Solana en utilisant le langage de programmation Rust.
Installez Rust avec rustup.
Exécutez la commande suivante pour installer Rust :
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Vous devriez voir le message suivant après la fin de l'installation :
Exécutez la commande suivante pour recharger votre variable d'environnement PATH afin d'inclure le répertoire bin de Cargo :
$. "$HOME/.cargo/env"
Pour vérifier que l'installation a réussi, vérifiez la version de Rust :
$rustc --version
Vous devriez voir une sortie comme celle-ci :
rustc 1.86.0 (05f9846f8 2025-03-31)
Installer la CLI Solana
La CLI Solana fournit tous les outils nécessaires pour créer et déployer des programmes Solana.
Installez la suite d'outils CLI Solana en utilisant la commande d'installation officielle :
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Vous pouvez remplacer stable
par le tag de version correspondant à la version
logicielle de votre choix (par exemple v2.0.3
), ou utiliser l'un des trois
noms de canaux symboliques : stable
, beta
, ou edge
.
Pour une première installation de la CLI Solana, vous pourriez voir le message
suivant vous invitant à ajouter une variable d'environnement PATH
:
Close and reopen your terminal to apply the PATH changes or run the following in your existing shell:export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
Si vous utilisez Linux ou WSL, vous devez ajouter le binaire CLI Solana
à votre PATH
afin que la commande soit disponible dans votre terminal.
D'abord, exécutez la commande suivante pour vérifier quel shell vous utilisez :
$echo $SHELL
- Si la sortie contient
/bash
, utilisez.bashrc
. - Si la sortie contient
/zsh
, utilisez.zshrc
.
Selon votre shell, exécutez la commande appropriée.
Pour Bash (bashrc
) :
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Pour Zsh (zshrc
) :
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
Ensuite, exécutez la commande suivante pour actualiser la session du terminal ou redémarrez votre terminal.
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
Pour vérifier que l'installation a réussi, vérifiez la version de la CLI Solana :
$solana --version
Vous devriez voir 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 validateur d'Anza, anciennement connu sous le nom de client validateur Solana Labs.
Pour mettre à jour ultérieurement la CLI Solana vers la dernière version, vous pouvez utiliser la commande suivante :
$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.
Vous pouvez installer la 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 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.
Installez AVM avec la commande suivante :
$cargo install --git https://github.com/coral-xyz/anchor avm --force
Confirmez qu'AVM a été installé avec succès :
$avm --version
Installez la dernière version d'Anchor CLI en utilisant AVM :
$avm install latest$avm use latest
Vous pouvez installer une version spécifique d'Anchor CLI en précisant le numéro de version :
$avm install 0.30.1$avm use 0.30.1
N'oubliez pas d'exécuter la commande avm use
pour déclarer la version
d'Anchor CLI à exécuter 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
.
Pour vérifier que l'installation a réussi, contrôlez la version d'Anchor CLI :
$anchor --version
Vous devriez voir une sortie similaire à celle-ci :
anchor-cli 0.31.1
Lors de l'installation d'Anchor CLI 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 :
- Installez les dépendances listées dans la section Linux en haut de cette page.
- Réessayez d'installer Anchor CLI.
Node.js et Yarn
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
)
Lors de l'exécution de anchor build
, si vous rencontrez les erreurs suivantes
:
Après avoir appliqué la solution précédente, essayez d'exécuter
anchor build
à nouveau.
Lors de l'exécution de anchor test
après avoir créé un nouveau projet
Anchor sur Linux ou WSL, vous pourriez rencontrer les erreurs suivantes si
Node.js ou Yarn ne sont pas installés :
Permission denied (os error 13)
No such file or directory (os error 2)
Notions de base de Solana CLI
Cette section présente quelques commandes courantes de Solana CLI pour vous aider à démarrer.
Configuration de Solana
Pour voir votre configuration actuelle :
$solana config get
Vous devriez voir une sortie comme celle-ci :
Config File: /Users/test/.config/solana/cli/config.ymlRPC URL: https://api.mainnet-beta.solana.comWebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)Keypair Path: /Users/test/.config/solana/id.jsonCommitment: confirmed
L'URL RPC et l'URL Websocket spécifient le cluster Solana auquel la CLI envoie des requêtes.
Vous pouvez mettre à jour le cluster Solana CLI en utilisant les commandes suivantes :
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
Vous pouvez également utiliser les options courtes suivantes :
$solana config set -um # For mainnet-beta$solana config set -ud # For devnet$solana config set -ul # For localhost$solana config set -ut # For testnet
Le chemin de la paire de clés pointe vers le portefeuille Solana par défaut
(keypair) utilisé par la CLI Solana pour payer les frais de transaction et
déployer des programmes. Par défaut, ce fichier est stocké à
~/.config/solana/id.json
.
Créer un portefeuille
Pour envoyer des transactions à l'aide de la CLI Solana, vous avez besoin d'un portefeuille Solana approvisionné en SOL.
Pour générer une paire de clés au chemin de paire de clés par défaut, exécutez la commande suivante :
$solana-keygen new
Vous devriez voir une sortie comme celle-ci :
Generating a new keypairFor added security, enter a BIP39 passphraseNOTE! This passphrase improves security of the recovery seed phrase NOT thekeypair file itself, which is stored as insecure plain textBIP39 Passphrase (empty for none):Wrote new keypair to /Users/test/.config/solana/id.json===========================================================================pubkey: 8dBTPrjnkXyuQK3KDt9wrZBfizEZijmmUQXVHpFbVwGT===========================================================================Save this seed phrase and your BIP39 passphrase to recover your new keypair:cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing===========================================================================
Si vous avez déjà un portefeuille système de fichiers enregistré à l'emplacement
par défaut, cette commande ne le remplacera pas, sauf si vous forcez
explicitement le remplacement en utilisant l'option --force
.
Pour afficher l'adresse de votre portefeuille (clé publique), exécutez :
$solana address
Airdrop de SOL
Demandez un airdrop de SOL sur votre portefeuille pour payer les transactions et les déploiements de programmes.
Configurez votre cluster sur le devnet :
$solana config set -ud
Puis demandez un airdrop de SOL devnet :
$solana airdrop 2
Les airdrops du devnet limitent les demandes à 5 SOL par requête. Si vous atteignez les limites de taux ou rencontrez des erreurs, essayez d'utiliser le Faucet Web à la place.
Pour vérifier le solde SOL de votre portefeuille, exécutez la commande suivante :
$solana balance
Exécuter un validateur local
La CLI Solana inclut un validateur de test intégré pour le développement local.
Dans un terminal séparé, exécutez la commande suivante pour démarrer un validateur local :
$solana-test-validator
N'oubliez pas de mettre à jour votre CLI pour utiliser localhost avant d'exécuter les commandes CLI Solana :
$solana config set -ul
Bases de la CLI Anchor
Cette section présente quelques commandes courantes de la CLI Anchor pour vous aider à démarrer. Pour plus d'informations sur la CLI Anchor, consultez la documentation Anchor.
Initialiser un projet
Pour créer un nouveau projet Anchor, exécutez la commande suivante :
$anchor init <project-name>
Par exemple, pour créer un projet appelé my-project
, exécutez :
$anchor init my-project
Cette commande crée un nouveau répertoire avec le nom du projet et initialise un nouveau projet Anchor avec un programme Rust de base et un modèle de test TypeScript.
Naviguez vers le répertoire du projet :
$cd <project-name>
Consultez la structure de fichiers du projet Anchor.
Compiler le programme
Pour compiler votre projet, exécutez la commande suivante :
$anchor build
Vous pouvez trouver le programme compilé dans le répertoire /target/deploy
.
Déployer le programme
Pour déployer votre projet, exécutez la commande suivante :
$anchor deploy
Cette commande déploie votre programme sur le cluster
spécifié dans le fichier
Anchor.toml
.
Tester le programme
Pour tester votre projet, exécutez la commande suivante :
$anchor test
Cette commande compile, déploie et exécute les tests pour votre projet.
Lorsque vous utilisez localnet
comme cluster
dans Anchor.toml
, Anchor
démarre automatiquement un validateur local, déploie votre programme, exécute
les tests, puis arrête le validateur.
Is this page helpful?