C#'teki Hataları ve Uyarıları Yapılandırma

Uyarılar ve Hataları Anlama

Video boyunca Derek, derleyici veya Roslyn analizörü uyarılarını hata olarak rapor etme konseptini tanıtır. Bunun gelecekteki sorunları önlemeye yardımcı olabilecek basit bir süreç olduğunu açıklar. Örneğin, async yöntemlerle çalışırken await anahtar kelimesini kullanmayı unutmak potansiyel hatalara yol açabilir. Derek, yönteminin SaveChangesAsync beklenmediği için bir uyarı tetiklediği bir senaryoyu gösterir. Bu tür uyarıların erken ele alınmasının önemini vurgular ve bu uyarıların daha sonra daha büyük sorunlara dönüşmesini önler.

Bu yaklaşım, kod kalitesini, sürdürülebilirliğini ve genel sistem istikrarını artırmaya yardımcı olur. Yapılandırma dosyaları, istisna işleme veya sistem ayarları ile uğraşıldığında, bu uyarıların nasıl etkili bir şekilde yönetileceğini anlamak, dayanıklı uygulamalar inşa etmenin anahtarıdır.

Uyarıları Hatalara Dönüştürme

Uyarıları hatalardan dönüştürmek için Derek, proje dosyasını (.csproj) değiştirmeyi önerir. CS4014 uyarısı (beklediğinizde oluşturulur) için, bu öğeyi eklemek uyarıyı hataya çevirir ve sorun devam ederse derlemenin başarısız olmasına neden olur. Bu yaklaşım, daha sıkı kodlama standartlarını zorlar ve potansiyel hataların uygulama geliştirme sürecinde erken yakalanmasına yardımcı olur.

<PropertyGroup>
  <WarningsAsErrors>CS4014</WarningsAsErrors>
</PropertyGroup>

<PropertyGroup>
  <WarningsAsErrors>CS4014</WarningsAsErrors>
</PropertyGroup>

Kavramı Roslyn Analizörlerine Uygulamak

Derek, Roslyn analizörleri için de bu yaklaşımı genişletiyor. Microsoft Visual Studio Threading Analyzer paketini örnek olarak kullanır.

Bu paketi projeye ekleyerek ve async sorununu yeniden tanıtarak Derek, Roslyn analizörü uyarılarının da hatalara dönüştürülebileceğini vurgular. Bu, kodlama standartlarını ve uygulamalarını zorlayan ekipler için özellikle yararlıdır. Bu uyarıları hatalar olarak ele alarak, geliştiriciler kodun çerçeve tarafından tanımlanan kılavuzlara dikkat ettiğinden emin olabilir ve üretimdeki potansiyel sorunlardan kaçınabilir.

<ItemGroup>
  <PackageReference Include="Microsoft.VisualStudio.Threading.Analyzers" Version="16.10.56" />
</ItemGroup>

<PropertyGroup>
  <WarningsAsErrors>VSTHRD103</WarningsAsErrors>
</PropertyGroup>

<ItemGroup>
  <PackageReference Include="Microsoft.VisualStudio.Threading.Analyzers" Version="16.10.56" />
</ItemGroup>

<PropertyGroup>
  <WarningsAsErrors>VSTHRD103</WarningsAsErrors>
</PropertyGroup>

Belli Başlı Uyarıları Yok Sayma

Bazen belirli uyarılar projenizle ilgili olmayabilir. Derek, proje dosyasında <NoWarn> öğesini kullanarak bu tür uyarıları nasıl göz ardı edeceğini tartışır. Asenkron adlandırma kuralı uyarısı (VSTHRD200) örneğini kullanır ve buna katılmadığı için <NoWarn> ekleyerek göz ardı etmeyi seçer. Bu özellik, geliştiricilerin uyarı ve hata raporlama sistemini belirli ihtiyaçlarına göre uyarlamalarına, projeleri için en önemli olan konulara odaklanmalarına ve önemsiz olanları gözardı etmelerine olanak tanır.

<PropertyGroup>
  <NoWarn>VSTHRD200</NoWarn>
</PropertyGroup>

<PropertyGroup>
  <NoWarn>VSTHRD200</NoWarn>
</PropertyGroup>

Çözüm Seviyesinde Yapılandırmalar

Ekstra bir ipucu olarak, Derek bu yapılandırmaları çözüm genelinde bir Directory.Build.props dosyası kullanarak nasıl uygulayacağını gösterir. Bu yaklaşım, ayarların çözüme dahil olan tüm projelerde tutarlı olmasını sağlayarak zaman kazandırır ve bütünlüğü korur. Bu yapılandırmaları merkezi bir dosyaya yerleştirerek, ekipler birden fazla projeyi kapsayan aynı kodlama standartları değerlerini ve kurallarını zorlayabilir, tüm kod tabanlarının aynı kılavuzlara uygun olmasını sağlar. Bu, gelişim aşamasındaki birden çok projeyi olan büyük ekipler veya organizasyonlar için özellikle yararlıdır.

<Project>
  <PropertyGroup>
    <WarningsAsErrors>CS4014;VSTHRD103</WarningsAsErrors>
    <NoWarn>VSTHRD200</NoWarn>
  </PropertyGroup>
</Project>

<Project>
  <PropertyGroup>
    <WarningsAsErrors>CS4014;VSTHRD103</WarningsAsErrors>
    <NoWarn>VSTHRD200</NoWarn>
  </PropertyGroup>
</Project>

Sonuç

Derek Comartin tarafından açıklanan çeşitli yapılandırma adımlarını takip ederek, C# projelerinizde derleyici ve Roslyn analizörü uyarılarını etkili bir şekilde yönetebilirsiniz. Uyarıları hatalar olarak yapılandırmak, yüksek kod kalitesini sürdürmeye ve potansiyel sorunların gözden kaçmasını önlemeye yardımcı olur. Derek'in C#'ta Hatalar ve Uyarıları Yapılandırma başlıklı tam videosunu izleyerek daha ayrıntılı bir yürüyüş yapabilirsiniz.