Dokumentacja SolanaPierwsze kroki

Instalacja

Ta sekcja opisuje kroki konfiguracji lokalnego środowiska do rozwoju Solana.

Szybka instalacja

Na Mac i Linux uruchom jedno polecenie, aby zainstalować wszystkie zależności.

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

Użytkownicy Windows: najpierw musisz zainstalować WSL (zobacz Instalacja zależności). Następnie uruchom powyższe polecenie w terminalu Ubuntu (Linux).

Po instalacji powinieneś zobaczyć wynik podobny do poniższego:

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

Jeśli polecenie szybkiej instalacji nie działa, zapoznaj się z sekcją Instalacja zależności poniżej, aby uzyskać instrukcje instalacji każdej zależności osobno.

Jeśli polecenie szybkiej instalacji zakończy się powodzeniem, przejdź do sekcji Podstawy Solana CLI i Podstawy Anchor CLI poniżej.

Instalacja zależności

Poniższe instrukcje prowadzą przez instalację każdej zależności osobno.

  • Użytkownicy Windows muszą najpierw zainstalować WSL (Windows Subsystem for Linux), a następnie zainstalować zależności określone w sekcji Linux poniżej.
  • Użytkownicy Linux powinni najpierw zainstalować zależności określone w sekcji Linux poniżej.
  • Użytkownicy Mac powinni zacząć od instrukcji instalacji Rust poniżej.

Zainstaluj Rust

Deweloperzy tworzą programy Solana, używając języka programowania Rust.

Zainstaluj Rust za pomocą rustup.

Uruchom następujące polecenie, aby zainstalować Rust:

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

Po zakończeniu instalacji powinien pojawić się następujący komunikat:

Uruchom następujące polecenie, aby przeładować zmienną środowiskową PATH, aby uwzględniała katalog bin Cargo:

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

Aby zweryfikować, czy instalacja zakończyła się sukcesem, sprawdź wersję Rust:

Terminal
$
rustc --version

Powinieneś zobaczyć wynik podobny do poniższego:

rustc 1.86.0 (05f9846f8 2025-03-31)

Zainstaluj Solana CLI

Solana CLI dostarcza wszystkie narzędzia potrzebne do tworzenia i wdrażania programów Solana.

Zainstaluj pakiet narzędzi Solana CLI za pomocą oficjalnego polecenia instalacyjnego:

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

Możesz zastąpić stable tagiem wydania odpowiadającym wersji oprogramowania twojego pożądanego wydania (np. v2.0.3), lub użyć jednej z trzech symbolicznych nazw kanałów: stablebeta, lub edge.

Podczas pierwszej instalacji Solana CLI możesz zobaczyć następujący komunikat, który zachęca do dodania zmiennej środowiskowej 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"

Jeśli używasz Linuxa lub WSL, musisz dodać binarkę Solana CLI do twojego PATH, aby polecenie było dostępne w terminalu.

Najpierw uruchom następujące polecenie, aby sprawdzić, której powłoki używasz:

Terminal
$
echo $SHELL
  • Jeśli wynik zawiera /bash, użyj .bashrc.
  • Jeśli wynik zawiera /zsh, użyj .zshrc.

W zależności od używanej powłoki uruchom odpowiednie polecenie.

Dla Bash (bashrc):

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

Dla Zsh (zshrc):

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

Następnie uruchom następujące polecenie, aby odświeżyć sesję terminala lub zrestartuj swój terminal.

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

Aby zweryfikować, czy instalacja zakończyła się sukcesem, sprawdź wersję Solana CLI:

Terminal
$
solana --version

Powinieneś zobaczyć wynik podobny do poniższego:

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

Możesz zobaczyć wszystkie dostępne wersje w repozytorium Agave na GitHubie.

Agave to klient walidatora od Anza, wcześniej znany jako klient walidatora Solana Labs.

Aby później zaktualizować Solana CLI do najnowszej wersji, możesz użyć następującego polecenia:

Terminal
$
agave-install update

Instalacja Anchor CLI

Anchor to framework do tworzenia programów Solana. Framework Anchor wykorzystuje makra w języku Rust, aby uprościć proces pisania programów Solana.

Możesz zainstalować Anchor CLI i narzędzia na dwa sposoby:

  1. Anchor Version Manager (AVM) - zalecana metoda instalacji
  2. Bez AVM - instalacja bezpośrednio z GitHuba

Anchor Version Manager (AVM) pozwala na instalację i zarządzanie różnymi wersjami Anchor na twoim systemie oraz łatwą aktualizację wersji Anchor w przyszłości.

Zainstaluj AVM za pomocą następującego polecenia:

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

Potwierdź, że AVM został pomyślnie zainstalowany:

Terminal
$
avm --version

Zainstaluj najnowszą wersję Anchor CLI za pomocą AVM:

Terminal
$
avm install latest
$
avm use latest

Możesz zainstalować konkretną wersję Anchor CLI, podając numer wersji:

Terminal
$
avm install 0.30.1
$
avm use 0.30.1

Nie zapomnij uruchomić polecenia avm use, aby zadeklarować wersję Anchor CLI, która ma działać na Twoim systemie.

  • Jeśli zainstalowałeś wersję latest, uruchom avm use latest.
  • Jeśli zainstalowałeś wersję 0.30.1, uruchom avm use 0.30.1.

Aby zweryfikować, czy instalacja zakończyła się sukcesem, sprawdź wersję Anchor CLI:

Terminal
$
anchor --version

Powinieneś zobaczyć wynik podobny do poniższego:

anchor-cli 0.31.1

Podczas instalacji Anchor CLI na Linuksie lub WSL możesz napotkać ten błąd:

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

Jeśli zobaczysz ten komunikat o błędzie:

  1. Zainstaluj zależności wymienione w sekcji Linux na początku tej strony.
  2. Spróbuj ponownie zainstalować Anchor CLI.

Node.js i Yarn

Domyślny plik testowy projektu Anchor (TypeScript) utworzony za pomocą polecenia anchor init wymaga Node.js i Yarn. (Szablon testowy w Rust jest dostępny przy użyciu anchor init --test-template rust)

Podczas uruchamiania anchor build, jeśli napotkasz następujące błędy:

Po zastosowaniu powyższego rozwiązania spróbuj ponownie uruchomić anchor build.

Podczas uruchamiania anchor test po utworzeniu nowego projektu Anchor na Linuxie lub WSL możesz napotkać następujące błędy, jeśli nie masz zainstalowanego Node.js lub Yarn:

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

Podstawy Solana CLI

Ta sekcja przeprowadza przez niektóre popularne polecenia Solana CLI, aby pomóc Ci zacząć.

Konfiguracja Solana

Aby zobaczyć swoją aktualną konfigurację:

Terminal
$
solana config get

Powinieneś zobaczyć wynik podobny do poniższego:

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

Adresy URL RPC i Websocket określają klaster Solana, do którego CLI wysyła żądania.

Możesz zaktualizować klaster Solana CLI za pomocą następujących poleceń:

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

Możesz również użyć następujących skróconych opcji:

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

Ścieżka Keypair wskazuje na domyślny portfel Solana (keypair) używany przez Solana CLI do opłacania opłat transakcyjnych i wdrażania programów. Domyślnie ten plik jest przechowywany w ~/.config/solana/id.json.

Utwórz portfel

Aby wysyłać transakcje za pomocą Solana CLI, potrzebujesz portfela Solana zasilonego w SOL.

Aby wygenerować keypair w domyślnej ścieżce Keypair, uruchom następujące polecenie:

Terminal
$
solana-keygen new

Powinieneś zobaczyć wynik podobny do poniższego:

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

Jeśli masz już portfel systemu plików zapisany w domyślnej lokalizacji, to polecenie nie nadpisze go, chyba że wyraźnie wymusisz nadpisanie za pomocą flagi --force.

Aby wyświetlić adres (klucz publiczny) swojego portfela, uruchom:

Terminal
$
solana address

Airdrop SOL

Poproś o airdrop SOL do swojego portfela, aby opłacić transakcje i wdrożenia programów.

Ustaw swój klaster na devnet:

Terminal
$
solana config set -ud

Następnie poproś o airdrop devnet SOL:

Terminal
$
solana airdrop 2

Airdropy na devnecie ograniczają żądania do 5 SOL na żądanie. Jeśli napotkasz limity lub błędy, spróbuj skorzystać z Web Faucet.

Aby sprawdzić saldo SOL w swoim portfelu, uruchom następujące polecenie:

Terminal
$
solana balance

Uruchom lokalny walidator

Solana CLI zawiera wbudowany testowy walidator do lokalnego developmentu.

W osobnym terminalu uruchom następujące polecenie, aby uruchomić lokalny walidator:

Terminal
$
solana-test-validator

Pamiętaj, aby również zaktualizować CLI do używania localhost przed uruchomieniem poleceń Solana CLI:

Terminal
$
solana config set -ul

Podstawy Anchor CLI

Ta sekcja przeprowadza przez kilka podstawowych poleceń Anchor CLI, aby pomóc Ci zacząć. Więcej informacji o Anchor CLI znajdziesz w dokumentacji Anchor.

Inicjalizacja projektu

Aby utworzyć nowy projekt Anchor, uruchom następujące polecenie:

Terminal
$
anchor init <project-name>

Na przykład, aby utworzyć projekt o nazwie my-project, uruchom:

Terminal
$
anchor init my-project

To polecenie tworzy nowy katalog o nazwie projektu i inicjalizuje nowy projekt Anchor z podstawowym programem w języku Rust oraz szablonem testów w TypeScript.

Przejdź do katalogu projektu:

Terminal
$
cd <project-name>

Zobacz strukturę plików projektu Anchor.

Budowanie programu

Aby zbudować swój projekt, uruchom następujące polecenie:

Terminal
$
anchor build

Skompilowany program znajdziesz w katalogu /target/deploy.

Wdrażanie programu

Aby wdrożyć swój projekt, uruchom następujące polecenie:

Terminal
$
anchor deploy

To polecenie wdraża Twój program do cluster określonego w pliku Anchor.toml.

Testowanie programu

Aby przetestować swój projekt, uruchom następujące polecenie:

Terminal
$
anchor test

To polecenie buduje, wdraża i uruchamia testy dla Twojego projektu.

Kiedy używasz localnet jako cluster w Anchor.toml, Anchor automatycznie uruchamia lokalny validator, wdraża Twój program, uruchamia testy, a następnie zatrzymuje validator.

Is this page helpful?