5. Doğrulama, güncelleme ve sorunlar

Kitaplar / Yöntem Kurulum Kılavuzu / 5. Doğrulama, güncelleme ve sorunlar

Kurulumu doğrulamak için yontem --surum komutunun sürüm numarasını yazması ve 2. adımdaki merhaba.y programının çalışması yeterlidir.

Yöntem’i kaynaktan kurduysanız kendi testlerini de çalıştırabilirsiniz; testlerin hepsi “geçti” demelidir.

Terminal

cd yontem
node js/betikler/test.js          # JavaScript derleyicisi
python3 testler/calistir.py       # Python yorumlayıcısı
node js/betikler/gomulu_test.js   # gömülü arka uç (C++ derleyicisi gerekir)

Güncelleme. Yeni sürüme geçmek için npm install -g yontem@latest yazmanız yeterlidir; kurulu sürümü yontem --surum ile görebilirsiniz. Kaynaktan kurduysanız yeni sürümü aldıktan sonra (git pull) yontem/js klasöründe npm install ve npm run build komutlarını yeniden çalıştırmanız gerekir.

Kaldırma. npm uninstall -g yontem komutu Yöntem’i kaldırır.

Sık karşılaşılan sorunlar

Belirti	Olası neden	Çözüm
`node`, `npm` ya da `python3` komutu bulunamadı	Kurulumdan sonra terminal yeniden açılmadı; Windows’ta PATH seçeneği işaretlenmedi	Terminali yeniden açabilirsiniz; Windows’ta `py` komutunu deneyebilir ya da Python’u PATH seçeneğiyle yeniden kurabilirsiniz
`yontem` komutu bulunamadı	Kurulum tamamlanmadı ya da npm’in genel klasörü PATH’te değil	Terminali yeniden açıp `npm install -g yontem` komutunu yineleyebilirsiniz; olmazsa `npx yontem program.y` ile çalıştırabilirsiniz
Kaynaktan kurarken `npm run build` sırasında `tsc` ya da `esbuild` bulunamadı	`npm install` atlandı	Önce `npm install`, sonra `npm run build` çalıştırılır
Derleyici beklenmedik sözdizimi hatasıyla çöküyor	Node.js 18’den eski	`node --version` ile sürüme bakıp Node.js’i güncelleyebilirsiniz
`npm install -g` “EACCES” veriyor (Linux, macOS)	Genel klasöre yazma izni yok	Node.js’i nvm ile kurabilir ya da `npx yontem` kullanabilirsiniz
Türkçe karakterler bozuk görünüyor (Windows)	Komut istemi UTF-8 değil	`chcp 65001` yazabilir ya da Windows Terminal kullanabilirsiniz
`kullan` ile açılan birim bulunamadı	Birim dosyası aranan klasörlerde değil	Dosyayı programın yanına ya da `kutuphane` alt klasörüne koyabilir veya `YONTEM_YOL`’a ekleyebilirsiniz
`--calistir` C++ derleyicisini bulamıyor	g++ kurulu değil ya da PATH’te değil	4. adımdaki tabloya göre kurabilir ya da `CXX` ile derleyiciyi gösterebilirsiniz
Kart yüklemede port bulunamadı	USB sürücüsü eksik ya da kablo yalnızca şarj kablosu	Kartın USB-seri sürücüsünü (CP210x ya da CH340) kurmanız ve bir veri kablosu kullanmanız gerekir

Sorun devam ederse hata mesajının tamamını, node --version ve yontem --surum çıktılarıyla birlikte paylaşabilirsiniz.