Kurulum
Bu bölüm, Solana geliştirme için yerel ortamınızı kurma adımlarını kapsar.
Hızlı Kurulum
Mac ve Linux'ta, tüm bağımlılıkları kurmak için bu tek komutu çalıştırın.
$curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash
Windows kullanıcıları: önce WSL'yi kurmalısınız (bkz. Bağımlılıkları Kur). Ardından yukarıdaki komutu Ubuntu (Linux) terminalinde çalıştırın.
Kurulumdan sonra, aşağıdakine benzer bir çıktı görmelisiniz:
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
Hızlı kurulum komutu çalışmazsa, lütfen her bir bağımlılığı ayrı ayrı kurmak için aşağıdaki Bağımlılıkları Kur bölümüne bakın.
Hızlı kurulum komutu başarıyla çalışırsa, aşağıdaki Solana CLI Temelleri ve Anchor CLI Temelleri bölümlerine geçin.
Bağımlılıkları Kur
Aşağıdaki talimatlar, her bir bağımlılığı ayrı ayrı kurma konusunda size rehberlik eder.
- Windows kullanıcıları önce WSL'yi (Windows için Linux Alt Sistemi) kurmalı ve ardından aşağıdaki Linux bölümünde belirtilen bağımlılıkları kurmalıdır.
- Linux kullanıcıları önce aşağıdaki Linux bölümünde belirtilen bağımlılıkları kurmalıdır.
- Mac kullanıcıları aşağıdaki Rust kurulum talimatlarıyla başlamalıdır.
Rust'ı Yükleyin
Geliştiriciler, Solana programlarını Rust programlama dili kullanarak oluşturur.
Rust'ı rustup ile yükleyin.
Rust'ı yüklemek için aşağıdaki komutu çalıştırın:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Kurulum tamamlandıktan sonra aşağıdaki mesajı görmelisiniz:
PATH ortam değişkeninizi yeniden yüklemek ve Cargo'nun bin dizinini dahil etmek için aşağıdaki komutu çalıştırın:
$. "$HOME/.cargo/env"
Kurulumun başarılı olduğunu doğrulamak için Rust sürümünü kontrol edin:
$rustc --version
Aşağıdakine benzer bir çıktı görmelisiniz:
rustc 1.86.0 (05f9846f8 2025-03-31)
Solana CLI'yi yükleyin
Solana CLI, Solana programlarını oluşturmak ve dağıtmak için gereken tüm araçları sağlar.
Resmi yükleme komutu kullanarak Solana CLI araç setini 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
(örneğin v2.0.3
) kullanabilir veya üç sembolik kanal adından birini
kullanabilirsiniz: stable
, beta
veya edge
.
Solana CLI'nin ilk kez kurulumunda, PATH
ortam değişkeni eklemenizi isteyen
aşağıdaki mesajı görebilirsiniz:
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"
Linux veya WSL kullanıyorsanız, komutun terminalinizde kullanılabilir
olması için Solana CLI ikili dosyasını PATH
değişkeninize eklemeniz gerekir.
Öncelikle, hangi kabuğu kullandığınızı kontrol etmek için aşağıdaki komutu çalıştırın:
$echo $SHELL
- Çıktı
/bash
içeriyorsa,.bashrc
kullanın. - Çıktı
/zsh
içeriyorsa,.zshrc
kullanın.
Kabuğunuza bağlı olarak, 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
Ardından terminal oturumunu yenilemek veya terminalinizi yeniden başlatmak için aşağıdaki komutu çalıştırın.
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
Kurulumun başarılı olduğunu doğrulamak için Solana CLI sürümünü kontrol edin:
$solana --version
Aşağıdakine benzer bir çıktı görmelisiniz:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Mevcut tüm sürümleri Agave Github deposunda görüntüleyebilirsiniz.
Agave, eskiden Solana Labs validator istemcisi olarak bilinen Anza tarafından geliştirilen validator istemcisidir.
Daha sonra Solana CLI'yi en son sürüme güncellemek için aşağıdaki komutu kullanabilirsiniz:
$agave-install update
Anchor CLI'yi kurma
Anchor, Solana programları geliştirmek için bir çerçevedir. Anchor çerçevesi, Solana programları yazma sürecini basitleştirmek için Rust makrolarından yararlanır.
Anchor CLI'yi ve araçlarını iki şekilde kurabilirsiniz:
- Anchor Version Manager (AVM) - Önerilen kurulum yöntemi
- AVM olmadan - Doğrudan GitHub'dan kurulum
Anchor sürüm yöneticisi (AVM), sisteminizde farklı Anchor sürümlerini kurmanıza ve yönetmenize ve gelecekte Anchor sürümlerini kolayca güncellemenize olanak tanır.
AVM'yi aşağıdaki komutla kurun:
$cargo install --git https://github.com/coral-xyz/anchor avm --force
AVM'nin başarıyla kurulduğunu doğrulayın:
$avm --version
AVM kullanarak Anchor CLI'nin en son sürümünü yükleyin:
$avm install latest$avm use latest
Sürüm numarasını belirterek belirli bir Anchor CLI sürümünü yükleyebilirsiniz:
$avm install 0.30.1$avm use 0.30.1
Sisteminizde çalıştırılacak Anchor CLI sürümünü belirtmek için avm use
komutunu çalıştırmayı unutmayın.
- Eğer
latest
sürümünü yüklediyseniz,avm use latest
komutunu çalıştırın. - Eğer
0.30.1
sürümünü yüklediyseniz,avm use 0.30.1
komutunu çalıştırın.
Kurulumun başarılı olduğunu doğrulamak için Anchor CLI sürümünü kontrol edin:
$anchor --version
Aşağıdakine benzer bir çıktı görmelisiniz:
anchor-cli 0.31.1
Linux veya WSL'de Anchor CLI'yi kurarken şu hatayı alabilirsiniz:
error: could not exec the linker cc = note: Permission denied (os error 13)
Bu hata mesajını görürseniz:
- Bu sayfanın üst kısmındaki Linux bölümünde listelenen bağımlılıkları yükleyin.
- Anchor CLI'yi yeniden yüklemeyi deneyin.
Node.js ve Yarn
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)
anchor build
çalıştırırken, aşağıdaki hatalarla karşılaşırsanız:
Yukarıdaki çözümü uyguladıktan sonra, anchor build
komutunu tekrar
çalıştırmayı deneyin.
Linux veya WSL'de yeni bir Anchor projesi oluşturduktan sonra
anchor test
komutunu çalıştırırken, Node.js veya Yarn yüklü değilse
aşağıdaki hatalarla karşılaşabilirsiniz:
Permission denied (os error 13)
No such file or directory (os error 2)
Solana CLI temelleri
Bu bölüm, başlamanıza yardımcı olmak için bazı yaygın Solana CLI komutlarını açıklar.
Solana yapılandırması
Mevcut yapılandırmanızı görmek için:
$solana config get
Aşağıdakine benzer bir çıktı görmelisiniz:
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
RPC URL ve Websocket URL, CLI'nin istekleri gönderdiği Solana kümesini belirtir.
Aşağıdaki komutları kullanarak Solana CLI kümesini güncelleyebilirsiniz:
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
Ayrıca aşağıdaki kısa seçenekleri de kullanabilirsiniz:
$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, Solana CLI tarafından işlem ücretlerini ödemek ve programları
dağıtmak için kullanılan varsayılan Solana cüzdanını (keypair) gösterir.
Varsayılan olarak, bu dosya ~/.config/solana/id.json
konumunda saklanır.
Cüzdan oluştur
Solana CLI kullanarak işlem göndermek için SOL ile fonlanmış bir Solana cüzdanına ihtiyacınız vardır.
Varsayılan Keypair Path konumunda bir keypair oluşturmak için aşağıdaki komutu çalıştırın:
$solana-keygen new
Aşağıdakine benzer bir çıktı görmelisiniz:
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===========================================================================
Eğer varsayılan konumda zaten kaydedilmiş bir dosya sistemi cüzdanınız varsa, bu
komut --force
bayrağını kullanarak açıkça zorlamadığınız sürece üzerine
yazmaz.
Cüzdanınızın adresini (açık anahtarını) görüntülemek için şunu çalıştırın:
$solana address
SOL airdrop al
İşlemler ve program dağıtımları için ödeme yapmak üzere cüzdanınıza SOL airdrop'u talep edin.
Kümenizi devnet'e ayarlayın:
$solana config set -ud
Ardından devnet SOL airdrop'u isteyin:
$solana airdrop 2
Devnet airdrop'ları, istek başına 5 SOL ile sınırlıdır. Eğer hız sınırlarına ulaşırsanız veya hatalarla karşılaşırsanız, bunun yerine Web Faucet kullanmayı deneyin.
Cüzdanınızın SOL bakiyesini kontrol etmek için aşağıdaki komutu çalıştırın:
$solana balance
Yerel validator çalıştırın
Solana CLI, yerel geliştirme için yerleşik bir test validator içerir.
Ayrı bir terminalde, yerel bir validator başlatmak için aşağıdaki komutu çalıştırın:
$solana-test-validator
Solana CLI komutlarını çalıştırmadan önce CLI'nizi localhost kullanacak şekilde güncellemeyi unutmayın:
$solana config set -ul
Anchor CLI temelleri
Bu bölüm, başlamanız için bazı yaygın Anchor CLI komutlarını açıklar. Anchor CLI hakkında daha fazla bilgi için Anchor dokümantasyonu'na bakın.
Projeyi başlatın
Yeni bir Anchor projesi oluşturmak için aşağıdaki komutu çalıştırın:
$anchor init <project-name>
Örneğin, my-project
adında bir proje oluşturmak için şunu çalıştırın:
$anchor init my-project
Bu komut, proje adıyla yeni bir dizin oluşturur ve temel bir Rust programı ve TypeScript test şablonuyla yeni bir Anchor projesi başlatır.
Proje dizinine gidin:
$cd <project-name>
Anchor projesinin dosya yapısına bakın.
Programı Derleme
Projenizi derlemek için aşağıdaki komutu çalıştırın:
$anchor build
Derlenmiş programı /target/deploy
dizininde bulabilirsiniz.
Programı Dağıtma
Projenizi dağıtmak için aşağıdaki komutu çalıştırın:
$anchor deploy
Bu komut, programınızı
Anchor.toml
dosyasında belirtilen cluster
üzerine dağıtır.
Programı Test Etme
Projenizi test etmek için aşağıdaki komutu çalıştırın:
$anchor test
Bu komut, projenizi derler, dağıtır ve testleri çalıştırır.
Anchor.toml
içinde cluster
olarak localnet
kullanıldığında, Anchor
otomatik olarak yerel bir validator başlatır, programınızı dağıtır, testleri
çalıştırır ve ardından validator'ı durdurur.
Is this page helpful?