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.

Terminal
$
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.1
Node.js: v23.11.0
Yarn: 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:

Terminal
$
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:

Terminal
$
. "$HOME/.cargo/env"

Per verificare che l'installazione sia avvenuta con successo, controlla la versione di Rust:

Terminal
$
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:

Terminal
$
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:

Terminal
$
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):

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
$
source ~/.bashrc

Per Zsh (zshrc):

Terminal
$
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.

Terminal
$
source ~/.bashrc # If using Bash
$
source ~/.zshrc # If using Zsh

Per verificare che l'installazione sia riuscita, controlla la versione della CLI di Solana:

Terminal
$
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:

Terminal
$
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:

  1. Anchor Version Manager (AVM) - Metodo di installazione consigliato
  2. 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:

Terminal
$
cargo install --git https://github.com/coral-xyz/anchor avm --force

Conferma che AVM sia stato installato correttamente:

Terminal
$
avm --version

Installa l'ultima versione di Anchor CLI utilizzando AVM:

Terminal
$
avm install latest
$
avm use latest

Puoi installare una versione specifica di Anchor CLI specificando il numero di versione:

Terminal
$
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, esegui avm use latest.
  • Se hai installato la versione 0.30.1, esegui avm use 0.30.1.

Per verificare che l'installazione sia riuscita, controlla la versione di Anchor CLI:

Terminal
$
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:

  1. Installa le dipendenze elencate nella sezione Linux all'inizio di questa pagina.
  2. 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:

Terminal
$
solana config get

Dovresti vedere un output simile al seguente:

Config File: /Users/test/.config/solana/cli/config.yml
RPC URL: https://api.mainnet-beta.solana.com
WebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)
Keypair Path: /Users/test/.config/solana/id.json
Commitment: 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:

Terminal
$
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:

Terminal
$
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:

Terminal
$
solana-keygen new

Dovresti vedere un output simile al seguente:

Generating a new keypair
For added security, enter a BIP39 passphrase
NOTE! This passphrase improves security of the recovery seed phrase NOT the
keypair file itself, which is stored as insecure plain text
BIP39 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:

Terminal
$
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:

Terminal
$
solana config set -ud

Poi richiedi un airdrop di SOL sulla devnet:

Terminal
$
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:

Terminal
$
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:

Terminal
$
solana-test-validator

Ricordati anche di aggiornare la tua CLI per utilizzare localhost prima di eseguire i comandi della CLI di Solana:

Terminal
$
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:

Terminal
$
anchor init <project-name>

Per esempio, per creare un progetto chiamato my-project, esegui:

Terminal
$
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:

Terminal
$
cd <project-name>

Consulta la struttura dei file del progetto Anchor.

Compila il programma

Per compilare il tuo progetto, esegui il seguente comando:

Terminal
$
anchor build

Puoi trovare il programma compilato nella directory /target/deploy.

Distribuisci il programma

Per distribuire il tuo progetto, esegui il seguente comando:

Terminal
$
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:

Terminal
$
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?