Derlemeyi bozmak: nedir, nedenleri ve projede nasıl önlenir

Geliştirmede derlemeyi bozmak nedir

Derlemeyi bozmak, değişiklikler yaptıktan sonra projenin derlenmeyi durdurması durumudur. CI/CD bağlamında bu, derleme hattının başarısız olduğu ve hiçbir yapıtın oluşturulmadığı anlamına gelir.

Mobil ve web geliştirme dünyasında derleme, kaynak kodun çalıştırılabilir bir dosyaya veya pakete dönüştürülmesi sürecidir. Android için Gradle aracılığıyla APK veya AAB oluşturmak; iOS için Xcode aracılığıyla derlemek; web projeleri için Webpack veya Vite aracılığıyla paketlemektir. Bu aşamaların herhangi birinde derlemeyi bozabilirsiniz.

Modern sürüm kontrol sistemleri ve Jenkins, GitHub Actions, GitLab CI gibi CI/CD araçları, bozuk bir derlemeyi otomatik olarak algılar ve ekibi bilgilendirir. Çoğu projede bir kural vardır: derleme bozuksa, derleme düzeltilene kadar diğer tüm görevlerin önceliği düşürülür.

fun main() {
    val message: String = "Build successful"
    println(message)
    
    // Bu satır derlemeyi bozar
    val number: Int = "not a number"
}

Bu örnekte, Int türündeki bir değişkene bir dize atamak derleme hatasına neden olur. Tür uyuşmazlığı, statik türlü dillerde derlemeyi bozmanın en yaygın nedenlerinden biridir.

Derleme hatasının ana nedenleri

Bozuk derlemeye yol açan birkaç hata kategorisi vardır. 2024 yılı GitLab analizine göre, nedenlerin dağılımı aşağıdaki gibidir.

En sinsi kategori bağımlılık sorunlarıdır. Bir modüldeki kütüphaneyi güncellemek, API veya yöntem davranışı değişirse komşu modülde derlemeyi bozabilir.

Buna karşılık, sözdizimi hataları hızla tespit edilir — derleyici tam satırı ve hata türünü belirtir. Bu nedenle statik türlü diller, derleme kararlılığı açısından dinamik türlü dillere göre daha güvenilir kabul edilir.

Bozuk derleme ekibi nasıl etkiler

Bozuk bir derleme, ekibin üretkenliğini doğrudan etkiler. Derleme başarısız olduğunda, geliştiriciler depodan projenin en son sürümünü alamaz ve CI hattı sonraki tüm değişiklikler için bloke olur.

Atlassian’ın 2023 tarihli bir araştırması, derlemenin dört saatten fazla bozuk kaldığı projelerin, ekibin üretken zamanının ortalama %25’ini kaybettiğini gösterdi. Geliştiriciler, görevlerini tamamlamak yerine sorunu teşhis etmeye yönelmek zorunda kalır.

Üretkenliğin yanı sıra, ekip morali de etkilenir. Derlemeyi bozan geliştirici, meslektaşlarından baskı hisseder. Sağlıklı ekiplerde kural şudur: bozuk derleme için cezalandırma, ancak acil düzeltme talep et. Suçsuz kültür, olayı birinin hatası olarak değil, sistemik bir sorun olarak analiz eden bir yaklaşımdır.

Dağıtık ekiplerde, bozuk bir derleme başka bir zaman dilimindeki meslektaşların çalışmasını bloke edebilir. Avrupa’daki bir geliştirici çıkmadan önce derlemeyi bozarsa, Asya’daki ekip düzeltmeyi beklerken tüm bir iş gününü kaybedebilir.

Bozuk derleme nasıl önlenir

Bozuk derlemenin önlenmesi, commit’ten önce yerel kontrollerle başlar. Her geliştirici, değişiklikleri göndermeden önce testleri ve derlemeyi çalıştırmalıdır. Ana önleme yöntemleri birkaç seviyeye ayrılmıştır.

• Pre-commit kancaları — lint araçları ve biçimlendiriciler dahil, commit oluşturmadan önce otomatik kontroller
• Yerel derleme — özellikle statik türlü diller için, göndermeden önce derlemeyi çalıştırma
• Birim testleri — erken gerileme tespiti için ana modüllerin testlerle kapsanması
• Kod incelemesi — ana dala birleştirmeden önce bir meslektaşın değişiklikleri gözden geçirmesi

İkinci seviye, CI/CD hattı yapılandırmasıdır. Her Çekme İsteği, birleştirmeden önce otomatik derleme ve testleri geçmelidir. Derleme başarısız olursa, PR düzeltilene kadar bloke edilir. Bu yaklaşıma gated commit denir ve çoğu modern projede kullanılır.

Üçüncü seviye, izleme ve istatistiklerdir. Ekipler MTTR (Ortalama Onarım Süresi) metriğini takip eder. Bu gösterge ne kadar düşükse, ekip bozuk derlemeye o kadar hızlı yanıt verir. Hedef değer 30 dakikayı geçmez.

Derleme bozuksa ne yapmalı

Derleme bozuk olduğunda, ilk adım hangi geliştiricinin son değişiklikleri yaptığını belirlemektir. Git, git bisect aracını sağlayarak ikili arama yoluyla derlemeyi bozan commit’i bulmanıza olanak tanır.

# Bilinen iyi ve kötü commit’lerle bisect başlat
git bisect start
git bisect bad HEAD
git bisect good abc1234

# Git ortadaki bir commit’i kontrol eder
# Derle ve test et, ardından işaretle:
git bisect good  # if build passes
git bisect bad   # if build fails

# ~log2(n) adımdan sonra git suçluyu gösterir
git bisect reset

Sorunlu commit’i bulduktan sonra iki olası eylem yolu vardır. İlki, düzeltme zaman gerektiriyorsa git revert kullanarak değişiklikleri geri almaktır. Bu, özellikle derleme tüm ekibi bloke ettiğinde en güvenli yaklaşımdır.

İkinci seçenek, yeni bir commit ile acil düzeltmedir. Bu yaklaşım, sorun yerel ve netse tercih edilir. Düzeltmeden sonra değişiklikleri gönderin ve derlemenin başarılı olduğunu onaylayın. Her durumda, derleme kurtarma süresi bir saati geçmemelidir.