5.2 | Mobil Debugging: Flutter ve Cihaz Logları

Mobil uygulama geliştirirken, kodunuz bilgisayarınızda (IDE) çalışsa da asıl hayat emülatörün veya gerçek telefonun içindedir. Flutter ile çalışırken karşılaştığımız o meşhur "siyah-sarı çizgili" ekranlar veya aniden kapanan uygulamalar, aslında bize bir şeyler anlatmaya çalışır. Ancak ajanınız, fiziksel olarak elinizdeki telefona dokunamadığı için bu işaretleri sizin toplamanız gerekir.

1. Flutter DevTools: Mobilin Röntgen Cihazı

Flutter, web tarayıcılarındaki "İncele" özelliğine benzer maar çok daha güçlü bir panel sunar: Flutter DevTools.

• Widget Inspector: Uygulamanızın görsel yapısını bir ağaç gibi görmenizi sağlar. Bir buton neden ekranın dışına taştı? Inspector ile o butona tıkladığınızda ajan projenizdeki hangi dosyanın, hangi satırının buna sebep olduğunu anında tespit eder.
• Layout Explorer: Görsel hataları (Overflow) canlı olarak düzeltmenize olanak tanır.

[Image of Flutter DevTools Widget Inspector showing application widget tree]

2. Logcat ve Debug Console: Telefonun Günlüğü

Uygulama çöktüğünde veya bir servis çalışmadığında, telefonun arka planında binlerce satır "log" akar.

• Ajanın Sınırı: Ajanınız IDE'deki terminali okuyabilir maar cihazın derinliklerindeki sistem hatalarını (örn: yetersiz bellek veya donanım izni reddi) kendiliğinden göremez.
• Nasıl Çözeriz? Debug Console'da çıkan o uzun hata dökümünü (stack trace) kopyalayıp ajana verin ve şunu ekleyin: "Uygulama emülatörde bu hatayla kapanıyor, sorun benim kodumda mı yoksa cihaz konfigürasyonunda mı?"

3. "RenderFlex Overflow" ve Görsel Hatalar

Flutter'da en sık karşılaşılan hata, içeriğin ekrana sığmamasıdır. Ajan bu hatayı koda bakarak tahmin edebilir maar gerçekte ne kadar taştığını ancak siz ona söylediğinizde net bir çözüm üretebilir.

• Strateji: DevTools'tan taşan kısmın miktarını görün, hatayı ajana bildirin ve ona "Bu ekranı farklı cihaz boyutlarına (responsive) uygun hale getir" talimatını verin.

[Image of Flutter RenderFlex overflow error with yellow and black stripes on mobile screen]

4. Kod Okuryazarlığı ile "Canlı" Takip

Mobil debugging yaparken sadece hatayı bulmak yetmez; uygulamanın performansını da izlemek gerekir. Ajan size "Bu fonksiyon çok yavaş" diyebilir maar bunun cihazın bataryasını nasıl etkilediğini anlamak için Performance sekmesine bakmanız gerekir. Kod Okuryazarlığınız geliştikçe, ajanın yazdığı kodun mobil donanım üzerinde ne kadar "hafif" çalıştığını denetleyebilir hale gelirsiniz.

Sözlük (Glossary)

• Widget Inspector: Flutter uygulamalarındaki arayüz elemanlarını incelemek için kullanılan görsel araç.
• Overflow Error: Bir görsel elemanın, kendisine ayrılan ekrana sığmayıp taşması durumu.
• Stack Trace: Bir hata oluştuğunda, hatanın hangi dosyalardan ve fonksiyonlardan geçerek buraya geldiğini gösteren yol haritası.
• Hot Reload: Flutter'da yapılan kod değişikliğinin uygulamayı baştan başlatmadan anında ekrana yansıması özelliği.

Sonraki Adım: 5.3 | Test Ortamı: Hataları Otomatik Yakalamak.