Asennus
Tämä osio kattaa vaiheet paikallisen ympäristön asentamiseen Solana-kehitystä varten.
Pika-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 pika-asennuskomento ei toimi, katso Asenna riippuvuudet -osiosta ohjeet jokaisen riippuvuuden asentamiseen erikseen.
Jos pika-asennuskomento suoritetaan onnistuneesti, siirry 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:
Sulje ja avaa terminaali uudelleen soveltaaksesi PATH-muutokset tai suorita seuraava komento nykyisessä shellissä:
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:iin, 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
Suorita sitten seuraava komento päivittääksesi terminaali-istunnon tai käynnistä terminaali uudelleen.
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
Tarkistaaksesi, että asennus onnistui, tarkista Solana CLI -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 Agaven Github-repossa.
Agave on validator-asiakasohjelma Anzalta, joka tunnettiin aiemmin Solana Labs validator -asiakasohjelmana.
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 version
latest, suoritaavm use latest. - Jos asensit version
0.30.1, suoritaavm use 0.30.1.
Tarkista asennuksen onnistuminen tarkistamalla Anchor CLI:n versio:
$anchor --version
Sinun pitäisi nähdä seuraavanlainen tuloste:
anchor-cli 0.31.1
Kun asennat Anchor CLI:n Linuxissa tai WSL:ssä, 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 komentoa anchor build, jos kohtaat seuraavia virheitä:
Kun olet soveltanut edellä mainittua ratkaisua, yritä ajaa anchor build
uudelleen.
Kun ajat anchor test uuden Anchor-projektin luomisen jälkeen Linuxissa
tai WSL:ssä, saatat kohdata seuraavat virheet, jos sinulla ei ole Node.js:ää tai
Yarnia asennettuna:
Permission denied (os error 13)
No such file or directory (os error 2)
Tekoälytyökalujen asentaminen Solana-kehitystä varten
Tässä osiossa kerrotaan valinnaisista tekoälytyökaluista, joita voit käyttää Solana-kehityksen nopeuttamiseen.
| Työkalu | Kuvaus | Linkki |
|---|---|---|
| MCP | MCP-palvelin, johon voit yhdistää kursorilla parantaaksesi Solanan tekoälyavusteista kehitystä. | https://mcp.solana.com/ |
| LLMs.txt | LLM-optimoitu dokumentaatio, jota voit käyttää LLM-mallien kouluttamiseen Solana-dokumentaatiolla. | https://solana.com/llms.txt |
Solana CLI:n perusteet
Tässä osiossa käydään läpi joitakin yleisiä Solana CLI -komentoja, joilla 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 seuraavilla komennoilla:
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
Voit myös käyttää 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-polku osoittaa oletusarvoiseen Solana-lompakkoon (keypair), jota Solana
CLI käyttää maksaakseen transaktiomaksuja ja ottaakseen käyttöön ohjelmia.
Oletusarvoisesti tämä tiedosto tallennetaan polkuun ~/.config/solana/id.json.
Luo lompakko
Lähettääksesi transaktioita Solana CLI:n avulla tarvitset Solana-lompakon, jossa on SOL-varoja.
Luodaksesi keypair-parin oletusarvoiseen keypair-polkuun, 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 oletussijainnissa,
tämä komento ei korvaa sitä, ellet nimenomaisesti pakota ylikirjoitusta
käyttämällä --force -lippua.
Nähdäksesi lompakkosi osoitteen (julkisen avaimen), suorita:
$solana address
SOL-pudotus (Airdrop)
Pyydä SOL-pudotusta lompakkoosi maksaaksesi transaktioita ja ohjelmien käyttöönottoja.
Aseta klusterisi devnetiin:
$solana config set -ud
Pyydä sitten devnet SOL -pudotusta:
$solana airdrop 2
Devnet-pudotukset rajoittavat pyynnöt 5 SOL:iin per pyyntö. Jos kohtaat rajoituksia tai virheitä, kokeile käyttää Web-faucetia sen sijaan.
Tarkistaaksesi lompakkosi SOL-saldon, suorita seuraava komento:
$solana balance
Käynnistä paikallinen validator
Solana CLI sisältää sisäänrakennetun testivalidatorin paikallista kehitystä varten.
Käynnistä erillisessä terminaalissa paikallinen validator 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:n 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.
Projektin alustaminen
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, joka sisältää perus-Rust-ohjelman ja TypeScript-testipohjan.
Siirry projektin hakemistoon:
$cd <project-name>
Tutustu Anchor-projektin tiedostorakenteeseen.
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
Anchor.toml
tiedostossa määritetyssä cluster ympäristössä.
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 vaihtoehtoa cluster asetuksena tiedostossa
Anchor.toml, Anchor käynnistää automaattisesti paikallisen validatorin, ottaa
ohjelmasi käyttöön, suorittaa testit ja pysäyttää sitten validatorin.
Is this page helpful?