Görev 14 — SA-MP hata ayıklama tamirhanesi
Kazanacağın yetenek: “Çalışmıyor” demek yerine sorunun aşamasını, beklenen davranışı ve kanıtını belirlemek.
Önce arızanın bölgesini bul
Bölüm başlığı “Önce arızanın bölgesini bul”| Belirti | Aşama | İlk kontrol |
|---|---|---|
.amx üretilmiyor |
Derleme | Pawno compiler çıktısı |
Run time error 19 |
Yükleme/bağımlılık | plugin, native ve server_log.txt |
| Gamemode bulunamıyor | Yapılandırma | gamemode0 ve dosya adı |
| Callback çalışmıyor | Olay akışı | callback imzası ve debug kaydı |
| MySQL callback’i çalışmıyor | Veritabanı | OnQueryError, callback adı ve sorgu kuyruğu |
| Eski oyuncuya veri geliyor | Asenkron akış | player session değeri ve bağlantı kontrolü |
| Yanlış oyuncu değişiyor | Veri modeli | playerid indeksi |
| Özellik iki kez çalışıyor | Script etkileşimi | gamemode ve filterscript callback’leri |
Compiler’da ilk hatadan başla
Bölüm başlığı “Compiler’da ilk hatadan başla”Bir eksik parantez aşağıdaki satırlarda onlarca ikincil hata oluşturabilir. En üstteki ilk gerçek hatayı düzelt, yeniden derle ve listeyi tekrar değerlendir.
undefined symbol: isim yanlış, bildirim görünür değil veya include eksik.invalid expression: parantez, virgül ya da operatör eksik.array index out of bounds: sabit indeks dizinin sınırını aşıyor.tag mismatch: beklenenFloat:veya başka tag ile verilen değer uyuşmuyor.symbol is never used: yarım kalmış veya gereksiz tanım var.
Uyarıyı #pragma warning disable ile susturmak son çare bile değildir; önce uyarının hangi yanlış varsayımı gösterdiğini bul.
Doğru AMX’in yüklendiğini kanıtla
Bölüm başlığı “Doğru AMX’in yüklendiğini kanıtla”academy.pwndosyasını kaydet.- F5 sonrası compiler’ın başarıyla tamamlandığını doğrula.
academy.amxdeğiştirilme saatini kontrol et.server.cfgiçindegamemode0 academy 1bulunduğunu doğrula.- Sunucuyu yeniden başlat ve
server_log.txtdosyasını incele.
Sürüm izi eklemek eski AMX şüphesini hızla çözer:
public OnGameModeInit(){ print("DEBUG build: academy-004"); return 1;}Akışı ölç
Bölüm başlığı “Akışı ölç”public OnPlayerEnterCheckpoint(playerid){ printf( "DEBUG checkpoint player=%d active=%d score=%d", playerid, PlayerData[playerid][isPlayerOnMission], PlayerData[playerid][playerScore] );
return 1;}Bu kayıt callback’in çağrılıp çağrılmadığını, doğru playerid değerini ve bellekteki durumu gösterir. Parola, token veya oyuncu parolası gibi gizli verileri loglama.
Lastik değişimi yöntemi
Bölüm başlığı “Lastik değişimi yöntemi”Sorunu küçültmek için:
- Tekrarlanabilir en kısa senaryoyu yaz.
- Son çalışan sürümle aradaki en küçük değişikliği bul.
- Büyük bloğu yarıya indirerek hatanın hangi tarafta kaldığını test et.
- Şüpheli davranışı küçük fonksiyona ayır.
- Her denemede yalnızca bir değişkeni değiştir.
Yardım konusu şablonu
Bölüm başlığı “Yardım konusu şablonu”SA-MP server sürümü:Pawn compiler sürümü:İşletim sistemi:Kullanılan include/plugin sürümleri:
Beklenen davranış:Gerçekleşen davranış:Tam hata metni:En küçük yeniden üretim kodu:Denenmiş çözümler:Ekran görüntüsü yerine hata metnini kod bloğunda paylaş. Böylece aranabilir, kopyalanabilir ve satır numarasıyla tartışılabilir olur.
Sezon finali
Bölüm başlığı “Sezon finali”Bu noktada kurulumu, derlemeyi, Pawn temelini, oyuncu verisini, fonksiyonları, callback akışını ve MySQL ile kalıcı veri yönetimini gördün. Bir sonraki mantıklı konular dialog, araç, pickup, timer ve modüler dosya yapısıdır. Bilmediğin bir API için önce ayrı fonksiyon veya callback referans sayfasını aç.