Instalasi
Bagian ini mencakup langkah-langkah untuk menyiapkan lingkungan lokal Anda untuk pengembangan Solana.
Instalasi Cepat
Di Mac dan Linux, jalankan perintah tunggal ini untuk menginstal semua dependensi.
$curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash
Pengguna Windows: Anda harus terlebih dahulu menginstal WSL (lihat Instal Dependensi). Kemudian jalankan perintah sebelumnya di terminal Ubuntu (Linux).
Setelah instalasi, Anda akan melihat output seperti berikut:
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
Jika perintah instalasi cepat tidak berfungsi, silakan merujuk ke bagian Instal Dependensi di bawah untuk petunjuk menginstal setiap dependensi secara individual.
Jika perintah instalasi cepat berhasil dijalankan, lanjutkan ke bagian Dasar-dasar Solana CLI dan Dasar-dasar Anchor CLI di bawah.
Instal Dependensi
Instruksi di bawah ini memandu Anda melalui proses instalasi setiap dependensi secara individual.
- Pengguna Windows harus terlebih dahulu menginstal WSL (Windows subsystem for Linux) dan kemudian menginstal dependensi yang ditentukan di bagian Linux di bawah ini.
- Pengguna Linux harus terlebih dahulu menginstal dependensi yang ditentukan di bagian Linux di bawah ini.
- Pengguna Mac harus memulai dengan instruksi instalasi Rust di bawah ini.
Instal Rust
Pengembang membangun program Solana menggunakan bahasa pemrograman Rust.
Instal Rust dengan rustup.
Jalankan perintah berikut untuk menginstal Rust:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Anda akan melihat pesan berikut setelah instalasi selesai:
Jalankan perintah berikut untuk memuat ulang variabel lingkungan PATH Anda agar menyertakan direktori bin Cargo:
$. "$HOME/.cargo/env"
Untuk memverifikasi bahwa instalasi berhasil, periksa versi Rust:
$rustc --version
Anda akan melihat output seperti berikut:
rustc 1.86.0 (05f9846f8 2025-03-31)
Instal Solana CLI
Solana CLI menyediakan semua alat yang diperlukan untuk membangun dan men-deploy program Solana.
Instal rangkaian alat Solana CLI menggunakan perintah instalasi resmi:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Anda dapat mengganti stable
dengan tag rilis yang sesuai dengan versi software
yang Anda inginkan (misalnya v2.0.3
), atau gunakan salah satu dari tiga nama
channel simbolis: stable
, beta
, atau edge
.
Untuk instalasi pertama kali Solana CLI, Anda mungkin akan melihat pesan berikut
yang meminta Anda untuk menambahkan variabel lingkungan 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"
Jika Anda menggunakan Linux atau WSL, Anda perlu menambahkan binary
Solana CLI ke PATH
agar perintah tersedia di terminal Anda.
Pertama, jalankan perintah berikut untuk memeriksa shell mana yang Anda gunakan:
$echo $SHELL
- Jika output berisi
/bash
, gunakan.bashrc
. - Jika output berisi
/zsh
, gunakan.zshrc
.
Tergantung pada shell Anda, jalankan perintah yang sesuai.
Untuk Bash (bashrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Untuk Zsh (zshrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
Kemudian jalankan perintah berikut untuk menyegarkan sesi terminal atau restart terminal Anda.
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
Untuk memverifikasi bahwa instalasi berhasil, periksa versi Solana CLI:
$solana --version
Anda akan melihat output seperti berikut:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Anda dapat melihat semua versi yang tersedia di Repo Github Agave.
Agave adalah validator client dari Anza, sebelumnya dikenal sebagai Solana Labs validator client.
Untuk memperbarui Solana CLI ke versi terbaru nanti, Anda dapat menggunakan perintah berikut:
$agave-install update
Instal Anchor CLI
Anchor adalah framework untuk mengembangkan program Solana. Framework Anchor memanfaatkan makro Rust untuk menyederhanakan proses penulisan program Solana.
Anda dapat menginstal Anchor CLI dan peralatannya dengan dua cara:
- Anchor Version Manager (AVM) - Metode instalasi yang direkomendasikan
- Tanpa AVM - Instal langsung dari GitHub
Anchor version manager (AVM) memungkinkan Anda menginstal dan mengelola berbagai versi Anchor di sistem Anda dan dengan mudah memperbarui versi Anchor di masa mendatang.
Instal AVM dengan perintah berikut:
$cargo install --git https://github.com/coral-xyz/anchor avm --force
Konfirmasi bahwa AVM berhasil diinstal:
$avm --version
Instal versi terbaru Anchor CLI menggunakan AVM:
$avm install latest$avm use latest
Anda dapat menginstal versi Anchor CLI tertentu dengan menentukan nomor versinya:
$avm install 0.30.1$avm use 0.30.1
Jangan lupa untuk menjalankan perintah avm use
untuk mendeklarasikan
versi Anchor CLI yang akan dijalankan di sistem Anda.
- Jika Anda menginstal versi
latest
, jalankanavm use latest
. - Jika Anda menginstal versi
0.30.1
, jalankanavm use 0.30.1
.
Untuk memverifikasi bahwa instalasi berhasil, periksa versi Anchor CLI:
$anchor --version
Anda akan melihat output seperti berikut:
anchor-cli 0.31.1
Saat menginstal Anchor CLI di Linux atau WSL, Anda mungkin mengalami error ini:
error: could not exec the linker cc = note: Permission denied (os error 13)
Jika Anda melihat pesan error ini:
- Instal dependensi yang tercantum di bagian Linux di bagian atas halaman ini.
- Coba instal ulang Anchor CLI.
Node.js dan Yarn
File tes proyek Anchor default (TypeScript) yang dibuat dengan perintah
anchor init
memerlukan Node.js dan Yarn. (Template tes Rust tersedia
menggunakan anchor init --test-template rust
)
Ketika menjalankan anchor build
, jika Anda mengalami error berikut:
Setelah menerapkan solusi di atas, coba jalankan anchor build
lagi.
Saat menjalankan anchor test
setelah membuat proyek Anchor baru di
Linux atau WSL, Anda mungkin mengalami error berikut jika Node.js atau Yarn
belum terpasang:
Permission denied (os error 13)
No such file or directory (os error 2)
Dasar-dasar Solana CLI
Bagian ini membahas beberapa perintah Solana CLI umum untuk membantu Anda memulai.
Konfigurasi Solana
Untuk melihat konfigurasi saat ini:
$solana config get
Anda akan melihat output seperti berikut:
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
URL RPC dan URL Websocket menentukan cluster Solana yang digunakan CLI untuk membuat permintaan.
Anda dapat memperbarui cluster Solana CLI menggunakan perintah berikut:
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
Anda juga dapat menggunakan opsi singkat berikut:
$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 menunjuk ke dompet Solana (keypair) default yang digunakan oleh
Solana CLI untuk membayar biaya transaksi dan men-deploy program. Secara
default, file ini disimpan di ~/.config/solana/id.json
.
Membuat dompet
Untuk mengirim transaksi menggunakan Solana CLI, Anda memerlukan dompet Solana yang diisi dengan SOL.
Untuk menghasilkan keypair di Keypair Path default, jalankan perintah berikut:
$solana-keygen new
Anda akan melihat output seperti berikut:
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===========================================================================
Jika Anda sudah memiliki dompet sistem file yang disimpan di lokasi default,
perintah ini tidak akan menimpanya kecuali Anda secara eksplisit memaksa
penimpaan menggunakan flag --force
.
Untuk melihat alamat dompet Anda (kunci publik), jalankan:
$solana address
Airdrop SOL
Minta airdrop SOL ke dompet Anda untuk membayar transaksi dan deployment program.
Atur cluster Anda ke devnet:
$solana config set -ud
Kemudian minta airdrop SOL devnet:
$solana airdrop 2
Airdrop devnet membatasi permintaan hingga 5 SOL per permintaan. Jika Anda mencapai batas rate atau mengalami error, coba gunakan Web Faucet sebagai alternatif.
Untuk memeriksa saldo SOL dompet Anda, jalankan perintah berikut:
$solana balance
Menjalankan validator lokal
Solana CLI menyertakan test validator bawaan untuk pengembangan lokal.
Di terminal terpisah, jalankan perintah berikut untuk memulai validator lokal:
$solana-test-validator
Ingat untuk memperbarui CLI Anda agar menggunakan localhost sebelum menjalankan perintah Solana CLI:
$solana config set -ul
Dasar-dasar Anchor CLI
Bagian ini membahas beberapa perintah Anchor CLI umum untuk membantu Anda memulai. Untuk informasi lebih lanjut tentang Anchor CLI, lihat dokumentasi Anchor.
Inisialisasi proyek
Untuk membuat proyek Anchor baru, jalankan perintah berikut:
$anchor init <project-name>
Misalnya, untuk membuat proyek bernama my-project
, jalankan:
$anchor init my-project
Perintah ini membuat direktori baru dengan nama proyek dan menginisialisasi proyek Anchor baru dengan program Rust dasar dan template pengujian TypeScript.
Navigasi ke direktori proyek:
$cd <project-name>
Lihat struktur file proyek Anchor.
Build Program
Untuk membangun proyek Anda, jalankan perintah berikut:
$anchor build
Anda dapat menemukan program yang telah dikompilasi di direktori
/target/deploy
.
Deploy Program
Untuk men-deploy proyek Anda, jalankan perintah berikut:
$anchor deploy
Perintah ini men-deploy program Anda ke cluster
yang ditentukan dalam file
Anchor.toml
.
Test Program
Untuk menguji proyek Anda, jalankan perintah berikut:
$anchor test
Perintah ini membangun, men-deploy, dan menjalankan pengujian untuk proyek Anda.
Ketika menggunakan localnet
sebagai cluster
di Anchor.toml
, Anchor secara
otomatis memulai validator lokal, men-deploy program Anda, menjalankan
pengujian, dan kemudian menghentikan validator.
Is this page helpful?