.NET Yükseltme Yardımcısı ile kod analizi nedir?

Bu makalede.NET Yükseltme Yardımcısı'nın kod çözümleme işlevine genel bir bakış sağlanır. Kod analizi, proje yapılandırmanıza, bağımlılıklarınıza ve kodunuz temelinde bir rapor oluşturur. Rapor, yükseltme sırasında karşılaşabileceğiniz olası sorunlar ve sorunlar ve bu sorunları düzeltmek için atabileceğiniz adımlar hakkında bilgi içerir.

Önemli

.NET Yükseltme Yardımcısı resmi olarak kullanım dışıdır. Bunun yerine, Visual Studio 2026 ve Visual Studio 2022 17.14.16 veya üzeri sürümlerde bulunan GitHub Copilot uygulama modernleştirme sohbet aracısını kullanın. Bu aracı projelerinizi ve bağımlılıklarınızı analiz eder, hedeflenen öneriler ve otomatik kod düzeltmeleri içeren adım adım bir geçiş planı oluşturur ve her değişikliği işleyerek doğrulayabilir veya geri alabilirsiniz. Proje dosyalarını güncelleştirme, kullanım dışı API'leri değiştirme ve derleme sorunlarını çözme gibi yaygın taşıma görevlerini otomatikleştirir, böylece el ile daha az çabayla daha hızlı modernleştirebilirsiniz.

Analiz türleri

Kodunuz üzerinde gerçekleştirebileceğiniz iki tür analiz vardır:

• Kaynak kodu ve ayarlar

  Kaynak kodunuzu, yapılandırmanızı ve ayarlarınızı analiz eder.

• İkili bağımlılıklar

  Projeleriniz için dış ikili bağımlılıkları (NuGet paketleri gibi) analiz eder.

Raporlar

Analiz tamamlandıktan sonra bir pano raporu oluşturulur. Bu rapor sonuçları projeye, dosyaya, olaya ve hikaye noktalarına göre ayırır. Hangi projede algılandıklarından bağımsız olarak benzer sorunları birlikte gruplandırmak için toplu görünüm de kullanılabilir.

İpucu

Hikaye noktaları, bir sorunu düzeltmek için gereken karmaşıklığı ve çabayı tahmin etmeye yardımcı olan çevik bir kavramdır. Daha fazla bilgi için Olay hikayesi noktaları bölümüne bakın.

Rapordaki her sorun, yapmanız gereken düzeltmeleri önceliklendirmenize yardımcı olmak için önem derecesine göre kategorilere ayrılmıştır. Sorunlar zorunlu veya isteğe bağlıdır. Zorunlu sorunlar yükseltmeyi engeller. İsteğe bağlı sorunlar, daha yeni bir özelliğe, kitaplığa veya kod geliştirmesine yükseltme fırsatı sağlar.

Aşağıdaki bölümlerde raporun alanları ayrıntılı olarak açıklanmaktadır.

Pano

Pano sayfası, tarama tarafından algılanan olayların paneller halinde gruplandırılmış bir görünümünü sağlar:

• Özet

  • Projeler

    Bu, bir olayın algılandığı proje sayısıdır.

  • Sorunlar

    Tarama sırasında tetiklenen benzersiz kuralların sayısı. Her sorunun, algılanan her örneğin (olay) yanı sıra kendi önem derecesi ve hikaye noktası vardır.

  • Olay

    Olay, kod parçası veya ikili dosya gibi belirli bir konumda algılanan bir sorunun örneğidir. Her olay, sorunu tetikleyen bağlamsal bilgileri içerir.

  • Yazı Noktaları

    Yükseltmeyi tamamlamak için gereken hikaye noktalarının toplam sayısı. Hikaye noktasının ne olduğu hakkında daha fazla bilgi için Olay hikayesi noktaları bölümüne bakın.

• Önem Derecesi ve Kategoriler

  Bu iki panel, olayları önem derecesine ve kategoriye göre gruplandıran grafikleri gösterir. Önem derecesi hakkında daha fazla bilgi için Olay önem derecesi bölümüne bakın.

Projeler

Projeler sayfası sorunları, olayları ve hikaye noktalarını projeye göre ayırır. Her proje, bu projeye filtrelenmiş bir detaya gitme raporu açan bir bağlantıdır.

Toplu sorunlar

Toplu sorunlar sayfası, tetiklenen her sorunun ayrıntılarını gösterir. Her sorun, bu sorunun her olayını listelenecek şekilde genişletilebilir. Durum sütunu, hangi sorunları düzeltmiş veya geçerli olmadığını kabul ettiğinizi izlemenize yardımcı olur.

Olay önem derecesi

Her sorun olayının, yükseltmeyi engelleyebilecek bir önem derecesi vardır. Önem derecesi, yükseltmenin başarılı olması için güncelleştirilecekleri anlamanıza yardımcı olur.

Önem Derecesi	Açıklama
Zorunlu	Ele alınmalıdır. Yükseltme işlemi, hedef çerçeve çalışma zamanını (TFM) güncelleştirme gibi bu sorunları sizin için işleyebilir.
İsteğe bağlı	Bunlar yükseltmeyle ilgili bir sorun oluşturmamalıdır, ancak yükseltmeden önce veya sonra bunları ele almayı düşünebilirsiniz.
Potansiyel	Yükselttikten sonra sorunlara neden olabilecek sorunlar ( bunları şimdi çözmezseniz).
Bilgiler	Yükseltmeyle ilgili ek bilgiler.

Olay hikayesi noktaları

Her sorun olayının ilişkili bir hikaye noktası vardır. Hikaye noktası, bir olayın karmaşıklığını ölçen ve bu olayı çözmek için gereken süreyi tahmin etmeye yardımcı olan bir ölçü birimidir. .NET Yükseltme Yardımcısı, aşağıdaki tabloya göre hikaye noktası değerlerini tanımlar:

Yazı Noktaları	Size
1	Önem -siz
3	Complex
5	Yeniden tasarla
7	Arkachitecture
13	Bilinmiyor

İlgili içerik

• .NET Yükseltme Yardımcısı ile projeleri analiz etme