Installazione
Questa sezione copre i passaggi per configurare il tuo ambiente locale per lo sviluppo su Solana.
Installazione rapida
Su Mac e Linux, esegui questo singolo comando per installare tutte le dipendenze.
$curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash
Utenti Windows: dovete prima installare WSL (vedi Installa dipendenze). Poi eseguite il comando precedente nel terminale Ubuntu (Linux).
Dopo l'installazione, dovresti vedere un output simile al seguente:
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
Se il comando di installazione rapida non funziona, fai riferimento alla sezione Installa dipendenze qui sotto per le istruzioni su come installare ogni dipendenza individualmente.
Se il comando di installazione rapida viene eseguito con successo, passa alle sezioni Nozioni di base della CLI di Solana e Nozioni di base della CLI di Anchor qui sotto.
Installa dipendenze
Le istruzioni qui sotto ti guidano attraverso l'installazione di ogni dipendenza individualmente.
- Gli utenti Windows devono prima installare WSL (Windows subsystem for Linux) e poi installare le dipendenze specificate nella sezione Linux qui sotto.
- Gli utenti Linux dovrebbero prima installare le dipendenze specificate nella sezione Linux qui sotto.
- Gli utenti Mac dovrebbero iniziare con le istruzioni di installazione di Rust qui sotto.
Installa Rust
Gli sviluppatori creano programmi Solana utilizzando il linguaggio di programmazione Rust.
Installa Rust con rustup.
Esegui il seguente comando per installare Rust:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Dovresti vedere il seguente messaggio dopo il completamento dell'installazione:
Esegui il seguente comando per ricaricare la tua variabile d'ambiente PATH per includere la directory bin di Cargo:
$. "$HOME/.cargo/env"
Per verificare che l'installazione sia avvenuta con successo, controlla la versione di Rust:
$rustc --version
Dovresti vedere un output simile al seguente:
rustc 1.86.0 (05f9846f8 2025-03-31)
Installa la CLI di Solana
La CLI di Solana fornisce tutti gli strumenti necessari per creare e distribuire programmi Solana.
Installa la suite di strumenti CLI di Solana utilizzando il comando di installazione ufficiale:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Puoi sostituire stable
con il tag di rilascio corrispondente alla versione del
software che desideri (ad esempio v2.0.3
), o utilizzare uno dei tre nomi
simbolici dei canali: stable
, beta
, o edge
.
Per una prima installazione della CLI di Solana, potresti vedere il seguente
messaggio che ti chiede di aggiungere una variabile d'ambiente 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"
Se stai utilizzando Linux o WSL, devi aggiungere il binario della CLI di
Solana al tuo PATH
in modo che il comando sia disponibile nel tuo terminale.
Prima, esegui il seguente comando per verificare quale shell stai utilizzando:
$echo $SHELL
- Se l'output contiene
/bash
, usa.bashrc
. - Se l'output contiene
/zsh
, usa.zshrc
.
A seconda della tua shell, esegui il comando appropriato.
Per Bash (bashrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Per Zsh (zshrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
Quindi esegui il seguente comando per aggiornare la sessione del terminale o riavvia il terminale.
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
Per verificare che l'installazione sia riuscita, controlla la versione della CLI di Solana:
$solana --version
Dovresti vedere un output simile al seguente:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Puoi visualizzare tutte le versioni disponibili nel repository Github di Agave.
Agave è il client validator di Anza, precedentemente noto come client validator di Solana Labs.
Per aggiornare successivamente la CLI di Solana all'ultima versione, puoi utilizzare il seguente comando:
$agave-install update
Installa Anchor CLI
Anchor è un framework per lo sviluppo di programmi Solana. Il framework Anchor sfrutta le macro di Rust per semplificare il processo di scrittura dei programmi Solana.
Puoi installare la CLI di Anchor e gli strumenti in due modi:
- Anchor Version Manager (AVM) - Metodo di installazione consigliato
- Senza AVM - Installa direttamente da GitHub
L'Anchor version manager (AVM) ti permette di installare e gestire diverse versioni di Anchor sul tuo sistema e aggiornare facilmente le versioni di Anchor in futuro.
Installa AVM con il seguente comando:
$cargo install --git https://github.com/coral-xyz/anchor avm --force
Conferma che AVM sia stato installato correttamente:
$avm --version
Installa l'ultima versione di Anchor CLI utilizzando AVM:
$avm install latest$avm use latest
Puoi installare una versione specifica di Anchor CLI specificando il numero di versione:
$avm install 0.30.1$avm use 0.30.1
Non dimenticare di eseguire il comando avm use
per dichiarare la
versione di Anchor CLI da eseguire sul tuo sistema.
- Se hai installato la versione
latest
, eseguiavm use latest
. - Se hai installato la versione
0.30.1
, eseguiavm use 0.30.1
.
Per verificare che l'installazione sia riuscita, controlla la versione di Anchor CLI:
$anchor --version
Dovresti vedere un output simile al seguente:
anchor-cli 0.31.1
Quando installi Anchor CLI su Linux o WSL, potresti incontrare questo errore:
error: could not exec the linker cc = note: Permission denied (os error 13)
Se vedi questo messaggio di errore:
- Installa le dipendenze elencate nella sezione Linux all'inizio di questa pagina.
- Riprova a installare Anchor CLI.
Node.js e Yarn
Il file di test predefinito del progetto Anchor (TypeScript) creato con il
comando anchor init
richiede Node.js e Yarn. (Il template di test Rust
è disponibile utilizzando anchor init --test-template rust
)
Quando esegui anchor build
, se riscontri i seguenti errori:
Dopo aver applicato la soluzione precedente, prova a eseguire nuovamente
anchor build
.
Quando esegui anchor test
dopo aver creato un nuovo progetto Anchor su
Linux o WSL, potresti incontrare i seguenti errori se non hai Node.js o Yarn
installati:
Permission denied (os error 13)
No such file or directory (os error 2)
Nozioni di base della CLI di Solana
Questa sezione illustra alcuni comuni comandi della CLI di Solana per aiutarti a iniziare.
Configurazione di Solana
Per vedere la tua configurazione attuale:
$solana config get
Dovresti vedere un output simile al seguente:
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 e l'URL Websocket specificano il cluster Solana a cui la CLI invia le richieste.
Puoi aggiornare il cluster della CLI Solana usando i seguenti comandi:
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
Puoi anche usare le seguenti opzioni abbreviate:
$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
Il percorso del keypair indica il wallet Solana predefinito (keypair) utilizzato
dalla CLI Solana per pagare le commissioni di transazione e distribuire i
programmi. Per impostazione predefinita, questo file è memorizzato in
~/.config/solana/id.json
.
Crea wallet
Per inviare transazioni utilizzando la CLI Solana, hai bisogno di un wallet Solana finanziato con SOL.
Per generare un keypair nel percorso predefinito, esegui il seguente comando:
$solana-keygen new
Dovresti vedere un output simile al seguente:
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===========================================================================
Se hai già un wallet nel file system salvato nella posizione predefinita, questo
comando non lo sovrascrive a meno che non forzi esplicitamente la sovrascrittura
usando il flag --force
.
Per visualizzare l'indirizzo del tuo wallet (chiave pubblica), esegui:
$solana address
Airdrop SOL
Richiedi un airdrop di SOL sul tuo wallet per pagare le transazioni e le distribuzioni dei programmi.
Imposta il tuo cluster sulla devnet:
$solana config set -ud
Poi richiedi un airdrop di SOL sulla devnet:
$solana airdrop 2
Gli airdrop sulla devnet limitano le richieste a 5 SOL per volta. Se raggiungi i limiti di frequenza o incontri errori, prova a utilizzare il Web Faucet invece.
Per verificare il saldo SOL del tuo wallet, esegui il seguente comando:
$solana balance
Esegui un validator locale
La CLI di Solana include un test validator integrato per lo sviluppo locale.
In un terminale separato, esegui il seguente comando per avviare un validator locale:
$solana-test-validator
Ricordati anche di aggiornare la tua CLI per utilizzare localhost prima di eseguire i comandi della CLI di Solana:
$solana config set -ul
Nozioni di base della CLI di Anchor
Questa sezione illustra alcuni comandi comuni della CLI di Anchor per iniziare. Per maggiori informazioni sulla CLI di Anchor, consulta la documentazione di Anchor.
Inizializza il progetto
Per creare un nuovo progetto Anchor, esegui il seguente comando:
$anchor init <project-name>
Per esempio, per creare un progetto chiamato my-project
, esegui:
$anchor init my-project
Questo comando crea una nuova directory con il nome del progetto e inizializza un nuovo progetto Anchor con un programma Rust di base e un template di test in TypeScript.
Naviga nella directory del progetto:
$cd <project-name>
Consulta la struttura dei file del progetto Anchor.
Compila il programma
Per compilare il tuo progetto, esegui il seguente comando:
$anchor build
Puoi trovare il programma compilato nella directory /target/deploy
.
Distribuisci il programma
Per distribuire il tuo progetto, esegui il seguente comando:
$anchor deploy
Questo comando distribuisce il tuo programma sul cluster
specificato nel file
Anchor.toml
.
Testa il programma
Per testare il tuo progetto, esegui il seguente comando:
$anchor test
Questo comando compila, distribuisce ed esegue i test per il tuo progetto.
Quando si utilizza localnet
come cluster
in Anchor.toml
, Anchor avvia
automaticamente un validator locale, distribuisce il tuo programma, esegue i
test e poi arresta il validator.
Is this page helpful?