Kod kapsamı uzantıları

Bu makalede, kod kapsamı özelliğiyle ilgili tüm Microsoft.Testing.Platform uzantıları listelenir ve açıklanır.

Projenizin kodunun birim testleri gibi kodlanmış testler tarafından hangi oranda test edildiğini belirlemek için kod kapsamı özelliğini kullanabilirsiniz. Hatalara karşı etkili bir şekilde koruma sağlamak için testlerinizin kodunuzun büyük bir kısmını alıştırma yapması veya kapsaması gerekir.

Microsoft kod kapsamı

Microsoft Kod Kapsamı analizi hem yönetilen (CLR) hem de yönetilmeyen (yerel) kod için mümkündür. Hem statik hem de dinamik izleme desteklenir. Bu uzantı, Microsoft.Testing.Extensions.CodeCoverage NuGet paketinin bir parçası olarak gönderilir.

Not

Yönetilmeyen (yerel) kod kapsamı, uzantıda varsayılan olarak devre dışı bırakılır. Gerekirse etkinleştirmek için EnableStaticNativeInstrumentation ve EnableDynamicNativeInstrumentation bayraklarını kullanın. Yönetilmeyen kod kapsamı hakkında daha fazla bilgi için statik ve dinamik yerleşik izlemebölümüne bakın.

Önemli

Paket, Microsoft .NET kitaplığının kapalı kaynaklı, ücretsiz kullanılabilir lisans modeliyle birlikte gönderilir.

Microsoft kod kapsamı hakkında daha fazla bilgi için GitHub sayfasınabakın.

Microsoft Kod Kapsamı aşağıdaki seçenekleri sağlar:

Seçenek	Açıklama
--coverage	dotnet-coverage aracını kullanarak kod kapsamını toplayın.
--coverage-output	Üretilen kapsam dosyasının adı veya yolu. Varsayılan olarak, dosya TestResults/<guid>.coverageolarak ayarlanır.
--coverage-output-format	Çıkış dosyası biçimi. Desteklenen değerler şunlardır: coverage, xmlve cobertura. Varsayılan değer coverage.
--coverage-settings	XML kod kapsamı ayarları.

Kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. ayarları ve örnekleri.

Not

Microsoft.Testing.Extensions.CodeCoverage aracında varsayılan değer IncludeTestAssembly, VSTest'te ise eski değer false yerine true olmuştur. Bu, test projelerinin varsayılan olarak dışlandığı anlamına gelir. Daha fazla bilgi için bkz. Kod Kapsamı yapılandırması.

Sürüm uyumluluğu

Aşağıdaki tabloda Microsoft.Testing.Extensions.CodeCoverage ile Microsoft.Testing.Platform'un farklı sürümleri arasındaki uyumluluk gösterilmektedir:

Microsoft.Testing.Extensions.CodeCoverage	Microsoft.Testing.Platform
18.1.x	2.0.x
18.0.x	1.8.x
17.14.x	1.6.2

Not

En iyi uyumluluk ve en son özellikler için her iki paketin de en son sürümlerini birlikte kullanmanız önerilir.

Yatak örtüsü

Önemli

coverlet.collector NuGet paketi vsTest için özel olarak tasarlanmıştır ve Microsoft.Testing.Platformile kullanılamaz.

Şu anda Bir Coverlet uzantısı yoktur, ancak Coverlet .NET genel aracınıkullanabilirsiniz.

Coverlet genel aracını zaten yüklediğinizi varsayarsak, şimdi şunları çalıştırabilirsiniz:

coverlet .\bin\Debug\net8.0\TestProject2.dll --target "dotnet" --targetargs "test .\bin\Debug\net8.0\TestProject2.dll --no-build"