Yerel Solana geliştirme ortamınızı kurma rehberi. Windows (WSL), Linux ve Mac'te Rust, Solana CLI ve Anchor Framework'ü nasıl yükleyeceğinizi öğrenin. Her bağımlılığı ayrı ayrı yüklemeyi tercih ediyorsanız veya hızlı kurulum herhangi bir nedenle başarısız olursa bu rehberi kullanın.
Ön koşullar
Rust kurulumu
Geliştiriciler Solana programlarını Rust programlama dilini kullanarak oluştururlar.
- Terminalinize aşağıdaki komutu girerek rustup kullanarak Rust'ı yükleyin:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Başarılı bir kurulumdan sonra aşağıdaki mesajı göreceksiniz:
- Cargo'nun bin dizinini içerecek şekilde PATH ortam değişkeninizi yeniden yükleyin:
$. "$HOME/.cargo/env"
- Kurulumun başarılı olduğunu doğrulayın.
$rustc --version
Aşağıdakine benzer bir çıktı göreceksiniz:
rustc 1.86.0 (05f9846f8 2025-03-31)
Solana CLI'yi yükleyin
Solana CLI, Solana programları oluşturmak ve dağıtmak için gereken tüm araçları sağlar.
- Resmi kurulum komutunu kullanarak Solana CLI araç paketini yükleyin:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
stable yerine istediğiniz sürümün yazılım sürümüyle eşleşen sürüm etiketini
(örn. v2.0.3) kullanabilir veya üç sembolik kanal adından birini
kullanabilirsiniz: stable, beta veya edge.
- PATH ortam değişkeni ekleyin
Solana CLI'nin ilk kez kurulumu sırasında bir PATH ortam değişkeni eklemeniz
istenebilir. Bunu yapmak için terminalinizi kapatıp yeniden açın veya
kabuğunuzda aşağıdaki komutu çalıştırın:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- PATH ortam değişkeninizi güncelleyin
Linux veya WSL kullanıyorsanız, komutun terminalinizde kullanılabilir olması için Solana CLI binary dosyasını PATH'inize eklemeniz gerekir. Bunu yapmak için aşağıdaki adımları izleyin:
a. Hangi kabuğu kullandığınızı kontrol edin:
$echo $SHELL
- Çıktı
/bashiçeriyorsa,.bashrckullanın. - Çıktı
/zshiçeriyorsa,.zshrckullanın.
b. Shell'inize göre uygun komutu çalıştırın.
Bash için (bashrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Zsh için (zshrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Terminalinizi yeniden başlatın veya terminal oturumunu yenilemek için aşağıdaki komutu çalıştırın:
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Solana CLI sürümünü kontrol ederek kurulumun başarılı olduğunu doğrulayın:
$solana --version
Aşağıdakine benzer bir çıktı göreceksiniz:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Tüm mevcut sürümleri Agave Github deposunda görüntüleyebilirsiniz. Agave, Anza'dan gelen validator istemcisidir, eskiden Solana Labs validator istemcisi olarak biliniyordu.
- Gerektiğinde Solana CLI'yi en son sürüme güncelleyin (İsteğe bağlı)
$agave-install update
Anchor CLI'yi yükleyin
Anchor, Solana programları geliştirmek için bir framework'tür. Anchor framework'ü, Solana programları yazma sürecini basitleştirmek için Rust makrolarından yararlanır.
Ön koşullar
anchor init komutuyla oluşturulan varsayılan Anchor proje test dosyası
(TypeScript), Node.js ve Yarn gerektirir. (Rust test şablonu
anchor init --test-template rust kullanılarak mevcuttur)
Kurulum
Anchor CLI ve araçlarını iki şekilde yükleyebilirsiniz:
- Anchor Version Manager (AVM) — Önerilen kurulum yöntemi
- AVM olmadan — Doğrudan GitHub'dan yükleme
Anchor Version Manager (AVM), sisteminizde farklı Anchor sürümlerini kurmanıza ve yönetmenize olanak tanır ve gelecekte Anchor sürümlerini kolayca güncellemenizi sağlar. Anchor'ı AVM kullanarak kurmak için aşağıdaki adımları izleyin:
- AVM'yi aşağıdaki komutla kurun:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- AVM'nin başarıyla kurulduğunu doğrulayın:
$avm --version
- AVM kullanarak Anchor CLI'yi kurun:
En son sürümü kurmak için:
$avm install latest$avm use latest
Belirli bir sürümü kurmak için sürüm numarasını belirtin:
$avm install 0.30.1$avm use 0.30.1
Anchor CLI'yi Linux veya WSL üzerinde kurarken şu hatayla karşılaşabilirsiniz:
error: could not exec the linker cc = note: Permission denied (os error 13)
Bu hata mesajını görürseniz şu adımları izleyin:
- Bu sayfanın üst kısmındaki Linux bölümünde listelenen bağımlılıkları kurun.
- Anchor CLI kurulumunu yeniden deneyin.
- Anchor CLI sürümünü kontrol ederek kurulumun başarılı olduğunu doğrulayın:
$anchor --version
Aşağıdakine benzer bir çıktı göreceksiniz:
anchor-cli 0.31.1
Sisteminizde çalıştırılacak Anchor CLI sürümünü bildirmek için avm use
komutunu çalıştırmayı unutmayın.
latestsürümünü kurduysanızavm use latestkomutunu çalıştırın.0.30.1sürümünü kurduysanızavm use 0.30.1komutunu çalıştırın.
Surfpool CLI'yi kurun
Surfpool, yerel geliştirme için bir araçtır ve
solana-test-validator için geliştirilmiş bir alternatiftir. Surfpool
özellikleri hakkında daha fazla bilgi için
Surfpool belgelerine göz atın.
- Aşağıdaki komutla Surfpool'u kurun:
$curl -sL https://run.surfpool.run/ | bash
- Kurulumun başarılı olduğunu, Surfpool CLI sürümünü kontrol ederek doğrulayın:
$surfpool --version
Aşağıdakine benzer bir çıktı göreceksiniz:
surfpool 0.12.0
Solana geliştirme için AI araçlarını kurun
Bu bölüm, Solana geliştirmenizi hızlandırmak için kullanabileceğiniz isteğe bağlı AI araç kurulumunu detaylandırır.
| Araç | Açıklama | Bağlantı |
|---|---|---|
| MCP | Solana AI destekli geliştirmeyi iyileştirmek için cursor ile bağlanabileceğiniz MCP sunucusu. | https://mcp.solana.com/ |
| LLMs.txt | LLM'leri Solana belgeleri üzerinde eğitmek için kullanabileceğiniz LLM optimize edilmiş belgeler. | https://solana.com/llms.txt |
Is this page helpful?