asdf Nedir ve Neden Kullanmalıyız?

Modern yazılım geliştirme dünyasında, farklı projeler genellikle farklı programlama dilleri ve bu dillerin farklı versiyonlarını gerektirir. Örneğin, bir projeniz Node.js 16 kullanırken, başka bir projeniz Node.js 18’e ihtiyaç duyabilir. Aynı durum Python, Ruby, Java, Go gibi birçok dil için de geçerlidir. Bu durum, geliştiriciler için versiyon çakışmaları ve karmaşık ortam kurulumları gibi zorluklar yaratabilir. İşte bu noktada asdf devreye girer.

asdf, bu tür çoklu dil ortamlarını yönetmek için geliştirilmiş güçlü, genişletilebilir bir versiyon yöneticisidir. Node.js için NVM, Python için pyenv, Ruby için RVM/rbenv gibi spesifik dil yöneticilerinin aksine, asdf tüm bu dilleri ve daha fazlasını tek bir tutarlı arayüz altında yönetmenizi sağlar. Bu, geliştirme ortamınızı sadeleştirir, bağımlılık çakışmalarını azaltır ve yeni bir projeye başlarken veya mevcut projeler arasında geçiş yaparken harcanan zamanı önemli ölçüde düşürür.

asdf’nin Avantajları:

Tek Arayüz: Tüm diller ve çalışma zamanları için aynı komut setini kullanırsınız (asdf install, asdf global, asdf local vb.).
Genişletilebilirlik: Plugin sistemi sayesinde istediğiniz programlama dilini veya aracı kolayca ekleyebilirsiniz. Topluluk tarafından desteklenen yüzlerce plugin mevcuttur.
Proje Başına Versiyon Yönetimi: Bir projenin kök dizininde oluşturulan .tool-versions dosyası sayesinde, o projeye özel dil versiyonlarını otomatik olarak etkinleştirir.
Global ve Yerel Kontrol: Tüm sisteminiz için global bir versiyon belirleyebilir veya belirli bir proje dizini için yerel bir versiyon atayabilirsiniz.
Hafif ve Hızlı: Bash betikleriyle yazılmış olması sayesinde hafif bir yapıya sahiptir ve hızlı çalışır.

Bu rehberde, Ubuntu 22.04 işletim sistemi üzerinde asdf’yi nasıl kuracağınızı ve Node.js ve Python gibi popüler dillerin farklı versiyonlarını nasıl yöneteceğinizi adım adım anlatacağız.

asdf Kurulum Öncesi Hazırlıklar

asdf’yi kurmadan ve kullanmadan önce, sisteminizin güncel olduğundan ve gerekli bağımlılıklara sahip olduğundan emin olmalıyız. Bu adımlar, asdf’nin kendisinin ve asdf aracılığıyla kuracağınız dil çalışma zamanlarının sorunsuz bir şekilde derlenip çalışabilmesi için kritik öneme sahiptir.

Sistem Güncellemesi ve Temel Bağımlılıklar

Terminali açın (Ctrl+Alt+T) ve aşağıdaki komutları çalıştırarak sisteminizi güncelleyin ve temel geliştirme araçlarını yükleyin:

sudo apt update
sudo apt upgrade -y
sudo apt install curl git build-essential -y

curl: İnternet üzerinden dosya indirmek için kullanılır.
git: asdf’nin kendisini ve asdf eklentilerini klonlamak için gereklidir.
build-essential: Derleme araçlarını (GCC, G++ ve make gibi) içerir. Bu, asdf aracılığıyla kuracağınız birçok dilin kaynak koddan derlenmesi için zorunludur.

Dil Çalışma Zamanları İçin Ek Bağımlılıklar

asdf aracılığıyla kuracağınız her dilin kendine özgü derleme bağımlılıkları olabilir. Özellikle Python ve Ruby gibi dilleri kaynak koddan derlerken bu bağımlılıklar hayati önem taşır. Aşağıdaki komut, yaygın olarak kullanılan dillerin (Python, Ruby, Node.js vb.) çoğu için gerekli olan ek paketleri yükler:

sudo apt install libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget llvm libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev -y

Bu paketler, SSL/TLS desteği, sıkıştırma kütüphaneleri, veritabanı bağlayıcıları ve diğer çeşitli derleme gereksinimlerini karşılar. Bu adımı atlamak, bazı dil versiyonlarını kurarken derleme hatalarıyla karşılaşmanıza neden olabilir.

asdf Temel Kurulumu

Gerekli hazırlıkları tamamladıktan sonra asdf’nin kendisini sistemimize kurmaya başlayabiliriz. Bu işlem, asdf’nin Git deposunu klonlamayı ve kabuk yapılandırmanıza eklemeyi içerir.

asdf Deposu Klonlama

asdf’yi kurmanın önerilen yolu, Git deposunu doğrudan kullanıcı dizininize klonlamaktır. Bu, asdf’yi güncellemeyi ve yönetmeyi kolaylaştırır. Klonlama işlemi için aşağıdaki komutu kullanın. Belirli bir kararlı sürümü (v0.14.0 gibi) klonlamak, gelecekteki olası uyumluluk sorunlarını önlemek için iyi bir pratiktir:

git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0

Bu komut, asdf’yi ~/.asdf dizinine klonlayacaktır. İstediğiniz zaman en son kararlı sürümü asdf GitHub Releases sayfasından kontrol edebilirsiniz.

Kabuk Yapılandırmasına Ekleme (Bash/Zsh)

asdf’nin komutlarını terminalde kullanabilmek için, kabuk ortamınıza asdf’nin betiklerini kaynak olarak eklemeniz gerekir. Kullandığınız kabuğa göre (Bash veya Zsh) aşağıdaki adımlardan birini uygulayın.

Bash Kullanıcıları İçin (.bashrc)

Eğer Bash kullanıyorsanız, ~/.bashrc dosyanızın sonuna aşağıdaki satırları ekleyin:

echo -e "\n. \"$HOME/.asdf/asdf.sh\"" >> ~/.bashrc
echo -e "\n. \"$HOME/.asdf/completions/asdf.bash\"" >> ~/.bashrc

İlk satır asdf’nin ana betiğini yüklerken, ikinci satır komut tamamlama (tab-completion) özelliğini etkinleştirir, bu da asdf komutlarını yazarken size büyük kolaylık sağlar.

Zsh Kullanıcıları İçin (.zshrc)

Eğer Zsh kullanıyorsanız, ~/.zshrc dosyanızın sonuna aşağıdaki satırları ekleyin:

echo -e "\n. \"$HOME/.asdf/asdf.sh\"" >> ~/.zshrc
echo -e "\n. \"$HOME/.asdf/completions/asdf.zsh\"" >> ~/.zshrc

Zsh kullanıcıları için de aynı mantık geçerlidir.

Kabuk Ortamını Yeniden Yükleme

Yapılandırma dosyalarını değiştirdikten sonra, değişikliklerin etkili olması için kabuk ortamınızı yeniden yüklemeniz gerekir. Bunu ya terminali kapatıp yeniden açarak ya da aşağıdaki komutlardan birini çalıştırarak yapabilirsiniz:

# Bash için:
source ~/.bashrc

Zsh için:
source ~/.zshrc

Kurulumu Doğrulama

asdf’nin başarıyla kurulduğunu doğrulamak için terminalde aşağıdaki komutu çalıştırın:

asdf --version

Ekranda asdf’nin yüklü versiyon numarasını görmeniz gerekir (örneğin, v0.14.0). Eğer bir hata alırsanız, yukarıdaki adımları dikkatlice kontrol edin.

asdf ile Dil Çalışma Zamanı Eklentileri ve Versiyon Yönetimi

asdf’nin kendisi kurulduktan sonra, sıra istediğimiz programlama dillerini ve araçlarını eklemeye ve yönetmeye gelir. Bu bölüm, asdf’nin en temel ve en sık kullanılan özelliklerini kapsar.

Eklenti (Plugin) Ekleme

asdf, her dil veya araç için ayrı bir “plugin” (eklenti) kullanır. Bu eklentiler, asdf’ye belirli bir dilin nasıl indirileceğini, derleneceğini ve kurulacağını öğretir. Mevcut tüm eklentileri listelemek için:

asdf plugin list all

Belirli bir eklentiyi aramak için grep ile filtreleyebilirsiniz:

asdf plugin list all | grep nodejs
asdf plugin list all | grep python

Bir eklentiyi sisteminize eklemek için asdf plugin add komutunu kullanın. Örneğin, Node.js ve Python için:

asdf plugin add nodejs
asdf plugin add python

Eklediğiniz eklentileri listelemek için:

asdf plugin list

Dil Versiyonlarını Yükleme

Eklentiyi ekledikten sonra, o dilin istediğiniz versiyonlarını yükleyebilirsiniz. Bir dilin mevcut tüm versiyonlarını görmek için:

asdf list-all nodejs
asdf list-all python

Belirli bir versiyonu yüklemek için asdf install komutunu kullanın. Ayrıca latest anahtar kelimesini kullanarak en son kararlı sürümü de yükleyebilirsiniz.

# Node.js'nin belirli bir versiyonunu yükleme
asdf install nodejs 18.17.1

Node.js'nin en son kararlı versiyonunu yükleme
asdf install nodejs latest

Python'ın belirli versiyonlarını yükleme
asdf install python 3.10.12
asdf install python 3.11.5

Yükleme işlemi, dilin boyutuna ve sisteminizin hızına bağlı olarak biraz zaman alabilir.

Global ve Yerel Versiyon Ayarlama

asdf, dil versiyonlarını iki seviyede yönetmenize olanak tanır:

Global Versiyon Ayarlama

Tüm sisteminizde varsayılan olarak kullanılacak bir dil versiyonunu ayarlamak için asdf global komutunu kullanın:

asdf global nodejs 18.17.1
asdf global python 3.10.12

Bu, ~/.tool-versions adlı bir dosya oluşturur veya günceller.

Yerel (Proje Başına) Versiyon Ayarlama

Belirli bir proje dizini için farklı bir versiyon kullanmak isterseniz, o dizine gidip asdf local komutunu kullanın:

cd ~/my_node_project
asdf local nodejs 16.20.2

cd ~/my_python_project
asdf local python 3.11.5

Bu komut, içinde bulunduğunuz dizine .tool-versions adlı bir dosya oluşturur. Bu dosya, projenin kaynak kontrol sistemine (Git gibi) dahil edilebilir, böylece tüm ekip üyeleri aynı dil versiyonlarını otomatik olarak kullanabilir.

Yüklü Versiyonları Listeleme ve Doğrulama

Yüklü dil versiyonlarını listelemek için:

asdf list nodejs
asdf list python

Hangi versiyonun şu anda aktif olduğunu doğrulamak için ilgili dilin versiyon komutunu kullanın:

node -v
npm -v
python --version
pip --version

Eğer bir projedeyseniz, .tool-versions dosyasında belirtilen versiyonun aktif olduğunu göreceksiniz. Proje dışındaysanız veya .tool-versions dosyası yoksa, global olarak ayarladığınız versiyon aktif olacaktır.

Versiyon Kaldırma

Artık ihtiyacınız olmayan bir dil versiyonunu kaldırmak için:

asdf uninstall nodejs 16.20.2
asdf uninstall python 3.10.12

Path Yenileme (Reshim)

Bazen yeni bir dil veya araç yükledikten sonra komutların bulunamadığı durumlarla karşılaşabilirsiniz. Bu, asdf’nin “shims” (yönlendirici betikler) mekanizmasının güncellenmesi gerektiği anlamına gelir. Genellikle bu otomatik olarak yapılır, ancak manuel olarak çalıştırmanız gerekirse:

asdf reshim

Sonuç ve Sıkça Sorulan Sorular (SSS)

Bu rehberde, Ubuntu 22.04 üzerinde asdf’yi nasıl kuracağınızı ve farklı programlama dillerinin versiyonlarını nasıl yöneteceğinizi öğrendiniz. asdf, geliştirme ortamınızı düzenlemenize, versiyon çakışmalarını önlemenize ve farklı projeler arasında sorunsuz geçiş yapmanıza olanak tanıyan paha biçilmez bir araçtır. Özellikle çok dilli projelerde çalışan veya birden fazla dil öğrenen geliştiriciler için asdf, verimliliği artıran vazgeçilmez bir yardımcıdır.

asdf’nin sunduğu esneklik ve genişletilebilirlik sayesinde, geliştirme sürecinizi çok daha akıcı hale getirebilirsiniz. Artık farklı dillerin farklı versiyonlarını kurmak ve yönetmek karmaşık bir görev olmaktan çıkıp, birkaç basit komutla halledilebilen standart bir işlem haline gelecektir.

Sıkça Sorulan Sorular (SSS)

1. asdf neden NVM, pyenv, rbenv gibi tek dil yöneticilerinden daha iyi?

asdf’nin temel avantajı, tüm dilleri ve çalışma zamanlarını tek bir tutarlı arayüz altında yönetmesidir. Her dil için farklı bir araç öğrenmek ve yapılandırmak yerine, asdf ile tek bir komut seti öğrenirsiniz. Bu, özellikle çok dilli geliştirme ortamlarında karmaşıklığı büyük ölçüde azaltır ve genel verimliliği artırır.

2. Bir dilin belirli bir sürümünü yükleyemiyorum, ne yapmalıyım?

Genellikle bu tür sorunlar, dilin derlenmesi için gerekli olan sistem bağımlılıklarının eksikliğinden kaynaklanır. Rehberin “Kurulum Öncesi Hazırlıklar” bölümündeki tüm sudo apt install komutlarını çalıştırdığınızdan emin olun. Özellikle build-essential ve dilin kendi özel kütüphaneleri (örneğin Python için libssl-dev, zlib1g-dev) eksik olabilir. Hata mesajını dikkatlice okuyarak eksik paketi tespit etmeye çalışın.

3. asdf yüklü versiyonları nerede saklar?

asdf, tüm eklentilerini ve yüklü dil versiyonlarını ~/.asdf dizini altında saklar. Örneğin, Node.js versiyonları ~/.asdf/installs/nodejs/ altında, Python versiyonları ise ~/.asdf/installs/python/ altında bulunur.

4. asdf’yi nasıl güncellerim?

asdf’yi güncellemek için, asdf deposunu klonladığınız dizine gidip Git komutlarını kullanabilirsiniz:

cd ~/.asdf
git pull
git checkout $(git describe --abbrev=0 --tags) # En son kararlı sürüme geçiş yapar

Daha sonra kabuğunuzu yeniden kaynaklamanız gerekebilir (source ~/.bashrc veya source ~/.zshrc).

5. `.tool-versions` dosyası ne işe yarar?

.tool-versions dosyası, asdf’ye belirli bir dizinde hangi dil versiyonlarının kullanılacağını söyler. Örneğin, bir projenin kök dizininde .tool-versions dosyası oluşturup içine nodejs 16.20.2 yazarsanız, o dizinde ve alt dizinlerinde Node.js komutlarını çalıştırdığınızda otomatik olarak 16.20.2 versiyonu kullanılacaktır. Bu dosya, projeler arasında versiyon tutarlılığını sağlamak için sürüm kontrol sistemine (Git) dahil edilebilir.

asdf Nedir ve Neden Kullanmalıyız?