Asennus

Tämä osio kattaa vaiheet paikallisen ympäristön asentamiseen Solana-kehitystä varten.

Nopea asennus

Macilla ja Linuxilla suorita tämä yksi komento asentaaksesi kaikki riippuvuudet.

Terminal
$
curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

Windows-käyttäjät: teidän täytyy ensin asentaa WSL (katso Asenna riippuvuudet). Suorita sitten edellä mainittu komento Ubuntu (Linux) -terminaalissa.

Asennuksen jälkeen sinun pitäisi nähdä seuraavanlainen tuloste:

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

Jos nopea asennuskomento ei toimi, katso alla olevasta Asenna riippuvuudet -osiosta ohjeet jokaisen riippuvuuden asentamiseen erikseen.

Jos nopea asennuskomento suoritetaan onnistuneesti, siirry suoraan Solana CLI perusteet ja Anchor CLI perusteet -osioihin alla.

Asenna riippuvuudet

Alla olevat ohjeet opastavat sinua asentamaan jokaisen riippuvuuden erikseen.

  • Windows-käyttäjien täytyy ensin asentaa WSL (Windows subsystem for Linux) ja sitten asentaa riippuvuudet, jotka on määritelty alla olevassa Linux-osiossa.
  • Linux-käyttäjien tulisi ensin asentaa riippuvuudet, jotka on määritelty alla olevassa Linux-osiossa.
  • Mac-käyttäjien tulisi aloittaa alla olevista Rust-asennusohjeista.

Asenna Rust

Kehittäjät rakentavat Solana-ohjelmia käyttäen Rust-ohjelmointikieltä.

Asenna Rust rustup-työkalulla.

Suorita seuraava komento asentaaksesi Rustin:

Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

Asennuksen valmistuttua sinun pitäisi nähdä seuraava viesti:

Suorita seuraava komento ladataksesi PATH-ympäristömuuttujasi uudelleen sisältämään Cargon bin-hakemisto:

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

Tarkistaaksesi, että asennus onnistui, tarkista Rust-versio:

Terminal
$
rustc --version

Sinun pitäisi nähdä seuraavanlainen tuloste:

rustc 1.86.0 (05f9846f8 2025-03-31)

Asenna Solana CLI

Solana CLI tarjoaa kaikki työkalut, joita tarvitaan Solana-ohjelmien rakentamiseen ja käyttöönottoon.

Asenna Solana CLI -työkalukokoelma käyttämällä virallista asennuskomentoa:

Terminal
$
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Voit korvata stable julkaisutagilla, joka vastaa haluamasi julkaisun ohjelmistoversiota (esim. v2.0.3), tai käyttää yhtä kolmesta symbolisesta kanavan nimestä: stable, beta tai edge.

Kun asennat Solana CLI:n ensimmäistä kertaa, saatat nähdä seuraavan viestin, joka kehottaa sinua lisäämään PATH ympäristömuuttujan:

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"

Jos käytät Linuxia tai WSL:ää, sinun täytyy lisätä Solana CLI -binääri PATH-polkuusi, jotta komento on käytettävissä terminaalissasi.

Tarkista ensin, mitä shelliä käytät, seuraavalla komennolla:

Terminal
$
echo $SHELL
  • Jos tuloste sisältää /bash, käytä .bashrc.
  • Jos tuloste sisältää /zsh, käytä .zshrc.

Suorita asianmukainen komento shellisi mukaan.

Bashille (bashrc):

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

Zshille (zshrc):

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

Päivitä sitten terminaali-istunto tai käynnistä terminaali uudelleen seuraavalla komennolla.

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

Tarkistaaksesi, että asennus onnistui, tarkista Solana CLI:n versio:

Terminal
$
solana --version

Sinun pitäisi nähdä seuraavanlainen tuloste:

solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

Voit tarkastella kaikkia saatavilla olevia versioita Agave Github -reposta.

Agave on validator-asiakasohjelma Anzalta, aiemmin tunnettu nimellä Solana Labs validator client.

Päivittääksesi Solana CLI:n myöhemmin uusimpaan versioon, voit käyttää seuraavaa komentoa:

Terminal
$
agave-install update

Asenna Anchor CLI

Anchor on kehys Solana-ohjelmien kehittämiseen. Anchor-kehys hyödyntää Rust-makroja yksinkertaistaakseen Solana-ohjelmien kirjoitusprosessia.

Voit asentaa Anchor CLI:n ja työkalut kahdella tavalla:

  1. Anchor Version Manager (AVM) - Suositeltu asennustapa
  2. Ilman AVM:ää - Asenna suoraan GitHubista

Anchor-versionhallinta (AVM) mahdollistaa eri Anchor-versioiden asentamisen ja hallinnan järjestelmässäsi sekä Anchor-versioiden helpon päivittämisen tulevaisuudessa.

Asenna AVM seuraavalla komennolla:

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

Varmista, että AVM asentui onnistuneesti:

Terminal
$
avm --version

Asenna Anchor CLI:n uusin versio AVM:n avulla:

Terminal
$
avm install latest
$
avm use latest

Voit asentaa tietyn Anchor CLI -version määrittämällä versionumeron:

Terminal
$
avm install 0.30.1
$
avm use 0.30.1

Muista suorittaa avm use -komento määrittääksesi järjestelmässäsi käytettävän Anchor CLI -version.

  • Jos asensit latest -version, suorita avm use latest.
  • Jos asensit version 0.30.1, suorita avm use 0.30.1.

Tarkistaaksesi, että asennus onnistui, tarkista Anchor CLI -versio:

Terminal
$
anchor --version

Sinun pitäisi nähdä seuraavanlainen tuloste:

anchor-cli 0.31.1

Kun asennat Anchor CLI:n Linuxiin tai WSL:ään, saatat kohdata tämän virheen:

error: could not exec the linker cc = note: Permission denied (os error 13)

Jos näet tämän virheilmoituksen:

  1. Asenna riippuvuudet, jotka on listattu Linux -osiossa tämän sivun alussa.
  2. Yritä asentaa Anchor CLI uudelleen.

Node.js ja Yarn

Oletusarvoinen Anchor-projektin testitiedosto (TypeScript), joka luodaan anchor init -komennolla, vaatii Node.js:n ja Yarnin. (Rust-testipohja on saatavilla käyttämällä anchor init --test-template rust)

Kun suoritat anchor build, jos kohtaat seuraavat virheet:

Kun olet soveltanut edellä mainittua ratkaisua, yritä suorittaa anchor build uudelleen.

Kun suoritat anchor test uuden Anchor-projektin luomisen jälkeen Linuxissa tai WSL:ssä, saatat kohdata seuraavia virheitä, jos Node.js tai Yarn ei ole asennettu:

Permission denied (os error 13)
No such file or directory (os error 2)

Solana CLI perusteet

Tässä osiossa käydään läpi joitakin yleisiä Solana CLI -komentoja, joiden avulla pääset alkuun.

Solana-konfiguraatio

Nähdäksesi nykyisen konfiguraatiosi:

Terminal
$
solana config get

Sinun pitäisi nähdä seuraavanlainen tuloste:

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

RPC URL ja Websocket URL määrittävät Solana-klusterin, johon CLI tekee pyyntöjä.

Voit päivittää Solana CLI -klusterin käyttämällä seuraavia komentoja:

Terminal
$
solana config set --url mainnet-beta
$
solana config set --url devnet
$
solana config set --url localhost
$
solana config set --url testnet

Voit käyttää myös seuraavia lyhyitä vaihtoehtoja:

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

Keypair Path osoittaa oletusarvoiseen Solana-lompakkoon (keypair), jota Solana CLI käyttää maksaakseen transaktiomaksuja ja ottaakseen käyttöön ohjelmia. Oletusarvoisesti tämä tiedosto tallennetaan sijaintiin ~/.config/solana/id.json.

Luo lompakko

Lähettääksesi transaktioita Solana CLI:n avulla tarvitset SOL:lla rahoitetun Solana-lompakon.

Luodaksesi keypair-parin oletusarvoiseen Keypair Path -sijaintiin, suorita seuraava komento:

Terminal
$
solana-keygen new

Sinun pitäisi nähdä seuraavanlainen tuloste:

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
===========================================================================

Jos sinulla on jo tiedostojärjestelmään tallennettu lompakko oletussijaintiin tallennettuna, tämä komento ei korvaa sitä, ellet nimenomaisesti pakota ylikirjoitusta käyttämällä --force lippua.

Nähdäksesi lompakkosi osoitteen (julkinen avain), suorita:

Terminal
$
solana address

SOL-pudotus

Pyydä SOL-pudotusta lompakkoosi maksaaksesi transaktioita ja ohjelmien käyttöönottoja.

Aseta klusterisi devnetiin:

Terminal
$
solana config set -ud

Pyydä sitten devnet SOL -airdrop:

Terminal
$
solana airdrop 2

Devnet-airdropit rajoittavat pyynnöt 5 SOL:iin per pyyntö. Jos kohtaat rajoituksia tai virheitä, kokeile käyttää Web Faucet -palvelua sen sijaan.

Tarkistaaksesi lompakkosi SOL-saldon, suorita seuraava komento:

Terminal
$
solana balance

Suorita paikallinen validator

Solana CLI sisältää sisäänrakennetun test validator -työkalun paikallista kehitystä varten.

Käynnistä paikallinen validator erillisessä terminaalissa seuraavalla komennolla:

Terminal
$
solana-test-validator

Muista myös päivittää CLI käyttämään localhostia ennen Solana CLI -komentojen suorittamista:

Terminal
$
solana config set -ul

Anchor CLI -perusteet

Tässä osiossa käydään läpi joitakin yleisiä Anchor CLI -komentoja, joilla pääset alkuun. Lisätietoja Anchor CLI:stä löydät Anchor-dokumentaatiosta.

Alusta projekti

Luodaksesi uuden Anchor-projektin, suorita seuraava komento:

Terminal
$
anchor init <project-name>

Esimerkiksi luodaksesi projektin nimeltä my-project, suorita:

Terminal
$
anchor init my-project

Tämä komento luo uuden hakemiston projektin nimellä ja alustaa uuden Anchor-projektin perus-Rust-ohjelmalla ja TypeScript-testimallipohjalla.

Siirry projektihakemistoon:

Terminal
$
cd <project-name>

Katso Anchor-projektin tiedostorakenne.

Ohjelman rakentaminen

Rakentaaksesi projektisi, suorita seuraava komento:

Terminal
$
anchor build

Löydät käännetyn ohjelman /target/deploy hakemistosta.

Ohjelman käyttöönotto

Ottaaksesi projektisi käyttöön, suorita seuraava komento:

Terminal
$
anchor deploy

Tämä komento ottaa ohjelmasi käyttöön cluster:ssa, joka on määritetty Anchor.toml tiedostossa.

Ohjelman testaaminen

Testataksesi projektiasi, suorita seuraava komento:

Terminal
$
anchor test

Tämä komento rakentaa, ottaa käyttöön ja suorittaa testit projektillesi.

Kun käytät localnet:a cluster:na Anchor.toml:ssa, Anchor käynnistää automaattisesti paikallisen validaattorin, ottaa ohjelmasi käyttöön, suorittaa testit ja sitten pysäyttää validaattorin.

Is this page helpful?