Panduan untuk menyiapkan lingkungan pengembangan Solana lokal Anda. Pelajari cara menginstal Rust, Solana CLI, dan Anchor Framework di Windows (WSL), Linux, dan Mac. Gunakan panduan ini jika Anda lebih suka menginstal setiap dependensi secara individual, atau jika instalasi cepat gagal karena alasan apa pun.
Prasyarat
Instal Rust
Developer membangun program Solana menggunakan bahasa pemrograman Rust.
- Instal Rust menggunakan rustup dengan memasukkan perintah berikut di terminal Anda:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Setelah instalasi berhasil, Anda akan melihat pesan berikut:
- Muat ulang variabel environment PATH Anda untuk menyertakan direktori bin Cargo:
$. "$HOME/.cargo/env"
- Verifikasi bahwa instalasi berhasil.
$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 Solana CLI tool suite dengan 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 dari rilis yang Anda inginkan (misalnya v2.0.3), atau gunakan salah
satu dari tiga nama channel simbolik: stable, beta, atau edge.
- Tambahkan variabel environment PATH
Instalasi pertama kali Solana CLI mungkin akan meminta Anda untuk menambahkan
variabel environment PATH. Untuk melakukannya, tutup dan buka kembali terminal
Anda atau jalankan perintah berikut di shell Anda:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Perbarui variabel environment PATH Anda
Jika Anda menggunakan Linux atau WSL, Anda harus menambahkan binary Solana CLI ke PATH Anda agar perintah tersebut tersedia di terminal Anda. Untuk melakukannya, ikuti langkah-langkah berikut:
a. Periksa shell mana yang Anda gunakan:
$echo $SHELL
- Jika output berisi
/bash, gunakan.bashrc. - Jika output berisi
/zsh, gunakan.zshrc.
b. Jalankan perintah yang sesuai, berdasarkan shell Anda.
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
- Restart terminal Anda atau jalankan perintah berikut untuk menyegarkan sesi terminal:
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Verifikasi bahwa instalasi berhasil dengan memeriksa 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 klien validator dari Anza, yang sebelumnya dikenal sebagai klien validator Solana Labs.
- Perbarui Solana CLI ke versi terbaru, jika diperlukan (Opsional)
$agave-install update
Instal Anchor CLI
Anchor adalah framework untuk mengembangkan program Solana. Framework Anchor memanfaatkan makro Rust untuk menyederhanakan proses penulisan program Solana.
Prasyarat
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)
Instalasi
Anda dapat menginstal Anchor CLI dan tooling dengan dua cara:
- Anchor Version Manager (AVM) — Metode instalasi yang direkomendasikan
- Tanpa AVM — Instal langsung dari GitHub
Anchor Version Manager (AVM) memungkinkan Anda untuk menginstal dan mengelola berbagai versi Anchor pada sistem Anda dan dengan mudah memperbarui versi Anchor di masa mendatang. Untuk menginstal Anchor menggunakan AVM, ikuti langkah-langkah berikut:
- Instal AVM dengan perintah berikut:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Konfirmasi bahwa AVM berhasil diinstal:
$avm --version
- Instal Anchor CLI menggunakan AVM:
Untuk menginstal versi terbaru:
$avm install latest$avm use latest
Untuk menginstal versi tertentu, tentukan nomor versinya:
$avm install 0.30.1$avm use 0.30.1
Saat menginstal Anchor CLI pada Linux atau WSL, Anda mungkin mengalami error berikut:
error: could not exec the linker cc = note: Permission denied (os error 13)
Jika Anda melihat pesan error ini, ikuti langkah-langkah berikut:
- Instal dependensi yang tercantum di bagian Linux di bagian atas halaman ini.
- Coba lagi menginstal Anchor CLI.
- Verifikasi bahwa instalasi berhasil, dengan memeriksa versi Anchor CLI:
$anchor --version
Anda akan melihat output seperti berikut:
anchor-cli 0.31.1
Jangan lupa untuk menjalankan perintah avm use untuk mendeklarasikan
versi Anchor CLI yang akan dijalankan pada sistem Anda.
- Jika Anda menginstal versi
latest, jalankanavm use latest. - Jika Anda menginstal versi
0.30.1, jalankanavm use 0.30.1.
Instal Surfpool CLI
Surfpool adalah alat untuk pengembangan lokal dan
pengganti yang lebih baik untuk solana-test-validator. Pelajari lebih lanjut
tentang fitur Surfpool di dokumentasi Surfpool.
- Instal Surfpool dengan perintah berikut:
$curl -sL https://run.surfpool.run/ | bash
- Verifikasi bahwa instalasi berhasil dengan memeriksa versi Surfpool CLI:
$surfpool --version
Anda akan melihat output seperti berikut:
surfpool 0.12.0
Siapkan tooling AI untuk pengembangan Solana
Bagian ini merinci pengaturan tooling AI opsional yang dapat Anda gunakan untuk mempercepat pengembangan Solana Anda.
| Tool | Deskripsi | Link |
|---|---|---|
| MCP | Server MCP yang dapat Anda hubungkan dengan cursor untuk meningkatkan pengembangan Solana berbasis AI. | https://mcp.solana.com/ |
| LLMs.txt | Dokumentasi yang dioptimalkan untuk LLM yang dapat Anda gunakan untuk melatih LLM pada dokumentasi Solana. | https://solana.com/llms.txt |
Is this page helpful?