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.
$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.1Node.js: v23.11.0Yarn: 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:
$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:
$. "$HOME/.cargo/env"
Tarkistaaksesi, että asennus onnistui, tarkista Rust-versio:
$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:
$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:
$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
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Zshille (zshrc
):
$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.
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
Tarkistaaksesi, että asennus onnistui, tarkista Solana CLI:n versio:
$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:
$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:
- Anchor Version Manager (AVM) - Suositeltu asennustapa
- 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:
$cargo install --git https://github.com/coral-xyz/anchor avm --force
Varmista, että AVM asentui onnistuneesti:
$avm --version
Asenna Anchor CLI:n uusin versio AVM:n avulla:
$avm install latest$avm use latest
Voit asentaa tietyn Anchor CLI -version määrittämällä versionumeron:
$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, suoritaavm use latest
. - Jos asensit version
0.30.1
, suoritaavm use 0.30.1
.
Tarkistaaksesi, että asennus onnistui, tarkista Anchor CLI -versio:
$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:
- Asenna riippuvuudet, jotka on listattu Linux -osiossa tämän sivun alussa.
- 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:
$solana config get
Sinun pitäisi nähdä seuraavanlainen tuloste:
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
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:
$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:
$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:
$solana-keygen new
Sinun pitäisi nähdä seuraavanlainen tuloste:
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===========================================================================
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:
$solana address
SOL-pudotus
Pyydä SOL-pudotusta lompakkoosi maksaaksesi transaktioita ja ohjelmien käyttöönottoja.
Aseta klusterisi devnetiin:
$solana config set -ud
Pyydä sitten devnet SOL -airdrop:
$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:
$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:
$solana-test-validator
Muista myös päivittää CLI käyttämään localhostia ennen Solana CLI -komentojen suorittamista:
$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:
$anchor init <project-name>
Esimerkiksi luodaksesi projektin nimeltä my-project
, suorita:
$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:
$cd <project-name>
Katso Anchor-projektin tiedostorakenne.
Ohjelman rakentaminen
Rakentaaksesi projektisi, suorita seuraava komento:
$anchor build
Löydät käännetyn ohjelman /target/deploy
hakemistosta.
Ohjelman käyttöönotto
Ottaaksesi projektisi käyttöön, suorita seuraava komento:
$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:
$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?