Solana-dokumentaatioAloittaminen

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.

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

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 seuraavalla komennolla, mitä shelliä käytät:

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

Suorita sitten seuraava komento päivittääksesi terminaali-istunnon tai käynnistä terminaali uudelleen.

Terminal
$ 
source ~/.bashrc # If using Bash

$ 
source ~/.zshrc # If using Zsh

Tarkista asennuksen onnistuminen tarkistamalla 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, joka tunnettiin aiemmin 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 version latest, 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ä ajaa anchor build uudelleen.

Kun ajat anchor test uuden Anchor-projektin luomisen jälkeen Linuxissa tai WSL:ssä, saatat kohdata seuraavia virheitä, 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ökaluKuvausLinkki
MCPMCP-palvelin, johon voit yhdistää cursorilla parantaaksesi Solanan tekoälyavusteista kehitystä.https://mcp.solana.com/
LLMs.txtLLM-optimoitu dokumentaatio, jota voit käyttää LLM-mallien kouluttamiseen Solana-dokumentaatiolla.https://solana.com/llms.txt

Solana CLI -perusteet

Tämä osio käy 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 myös käyttää 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ää transaktioiden maksuihin ja ohjelmien käyttöönottoon. Oletusarvoisesti tämä tiedosto tallennetaan polkuun ~/.config/solana/id.json.

Luo lompakko

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

Luodaksesi keypair-tiedoston oletuspolkuun, 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 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:

Terminal
$ 
solana address

SOL-airdrop

Pyydä SOL-airdrop 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.

Tarkistaaksesi lompakkosi SOL-saldon, suorita seuraava komento:

Terminal
$ 
solana balance

Paikallisen validatorin käynnistäminen

Solana CLI sisältää sisäänrakennetun testivalidatorin 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ämä osio käy 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 projektin hakemistoon:

Terminal
$ 
cd <project-name>

Katso Anchor-projektin tiedostorakenne.

Rakenna ohjelma

Rakentaaksesi projektisi, suorita seuraava komento:

Terminal
$ 
anchor build

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

Ota ohjelma käyttöön

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

Terminal
$ 
anchor deploy

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

Testaa ohjelma

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 komentoa cluster parametrina Anchor.toml komennossa, Anchor käynnistää automaattisesti paikallisen validatorin, ottaa ohjelmasi käyttöön, suorittaa testit ja pysäyttää sitten validatorin.

Is this page helpful?

Edellinen

Useiden ohjelmien yhdistäminen

Seuraava

Ydinkäsitteet

Sisällysluettelo

Muokkaa sivua

Hallinnoi

© 2025 Solana Foundation. Kaikki oikeudet pidätetään.
Solana
Yhdistä
© 2025 Solana Foundation. Kaikki oikeudet pidätetään.