VSTest Köprüsü uzantısı

Bu uzantı, VSTest ile bir uyumluluk katmanı sağlar ve buna bağlı olarak test çerçevelerinin VSTest modunda (vstest.console.exe, normal dotnet test, AzDo'da VSTest task, Visual Studio Test Explorer'ları ve Visual Studio Code...) çalışmaya devam etmesi sağlanır. Bu uzantı, Microsoft.Testing.Extensions.VSTestBridge paketinin bir parçası olarak gönderilir.

VSTest ile uyumluluk

Bu uzantının temel amacı, yeni platformun etkinleştirildiği ve paralel olarak uyumluluk modunun sunulduğu çift mod sunarak VSTest kullanıcılarına kolay ve sorunsuz bir yükseltme deneyimi sağlamaktır. Bu sayede alışıldık iş akışlarının devam etmeye imkân tanınır.

Runsettings desteği

Bu uzantı, VSTest .runsettings dosyasağlamanıza olanak tanır, ancak bu dosyadaki tüm seçenekler platform tarafından alınmaz. En çok kullanılan VSTest yapılandırma seçenekleri için desteklenen ve desteklenmeyen ayarları, yapılandırma seçeneklerini ve alternatifleri aşağıda açıklıyoruz.

Test çerçevesi etkinleştirildiğinde, --settings <SETTINGS_FILE> dosyasını sağlamak için .runsettings kullanabilirsiniz.

RunConfiguration öğesi

Aşağıdaki RunConfiguration öğeleri Microsoft.Testing.Platformtarafından desteklenmez:

Düğüm	Açıklama	Neden / Geçici Çözüm
MaxCpuCount	Bu ayar, işlem düzeyinde paralellik düzeyini denetler. İşlem düzeyinde paralellik üst sınırını etkinleştirmek için 0 kullanın.	MSBuild ile Microsoft.Testing.Platform kullanıldığında, bu seçenek MSBuild'e devredilir. Tek bir yürütülebilir dosya çalıştırıldığında, bu seçeneğin Microsoft.Testing.Platform için bir anlamı yoktur.
SonuçlarDizini	Test sonuçlarının yerleştirildiği dizin. Yol, .runsettings dosyasını içeren dizine göredir.	Test sonuçlarının yerleştirileceği dizini belirlemek için --results-directory komut satırı seçeneğini kullanın. Belirtilen dizin yoksa oluşturulur. Varsayılan değer, test uygulamasını içeren dizinde TestResults.
TargetFrameworkVersion	Bu ayar, testleri çalıştırmak için kullanılacak çerçeve sürümünü veya çerçeve ailesini tanımlar.	Bu seçenek yoksayılır. <TargetFramework> veya <TargetFrameworks> MSBuild özellikleri uygulamanın hedef çerçevesini belirler. Testler son uygulamada barındırılır.
HedefPlatform	Bu ayar, testleri çalıştırmak için kullanılacak mimariyi tanımlar.	<RuntimeIdentifier> testleri barındıran son uygulamanın mimarisini belirler.
TestAdaptörüHatalarınıUyarıOlarakDeğerlendir	Uyarı haline gelmek için test bağdaştırıcısı hatalarını bastırır.	Microsoft.Testing.Platform tek bir derlemeden yalnızca bir tür testin çalıştırılmasına izin verir ve bazı testlerin bulunamadığı veya çalıştırılamadığına işaret ettiği için test çerçevesinin veya altyapının diğer bölümlerinin yüklenememesi atlanamayan bir hataya dönüşür.
TestAdaptörYolları	TestAdapter'ların bulunduğu dizine bir veya daha fazla yol	Microsoft.Testing.Platform, test bağdaştırıcıları kavramını kullanmaz ve derlemenin bir parçası olmadıkça ve Program.cs'de derleme hedefleri aracılığıyla otomatik olarak veya el ile kaydedilmedikleri sürece uzantıların dinamik yüklenmesine izin vermez.
TestCaseFilter	Çalıştırılacak testleri sınırlamak için bir filtre.	v1.6'dan başlayarak bu runsettings girdisi artık desteklenmektedir. Bu sürümden önce, bunun yerine --filter komut satırı seçeneğini kullanmalısınız.
TestSessionTimeout	Kullanıcıların belirli bir zaman aşımını aştığında test oturumlarını sonlandırmasına izin verir.	Alternatif seçenek yoktur.
DotnetHostPath	Test ana bilgisayarını çalıştırmak için kullanılan dotnet konağı için özel bir yol belirtin.	Microsoft.Testing.Platform, dotnet ile ilgili hiçbir ek çözümleme yapmıyor. Bu, dotnet'in kendisini nasıl çözümlediğine bağlıdır ve bu da DOTNET_HOST_PATHgibi ortam değişkenleri tarafından denetlenebilir.
TestYoksaHataOlarakDeğerlendir	Hiçbir test bulunamıyorsa sıfır olmayan çıkış koduyla çıkın.	Microsoft.Testing.Platform, bir test uygulamasında hiçbir test keşfedilmeyip çalıştırıldığında varsayılan olarak hata oluşturur. Varsayılan olarak 1 olan --minimum-expected-tests komut satırı parametresini kullanarak derlemede bulmayı beklediğiniz test sayısını ayarlayabilirsiniz.

DataCollectors öğesi

Microsoft.Testing.Platform veri toplayıcıları kullanmıyor. Bunun yerine, işlem içi ve işlem dışı uzantılar kavramına sahiptir. Her uzantı, ilgili yapılandırma dosyası tarafından veya komut satırı aracılığıyla yapılandırılır.

En önemlisi askıda kalma ve kilitlenme uzantısı ile kod kapsamı uzantısı.

LoggerRunSettings öğesi

Microsoft.Testing.Platform kaydediciler, komut satırı parametreleri veya kod içindeki ayarlar aracılığıyla yapılandırılır.

VSTest filtre desteği

Bu uzantı, yalnızca filtre ifadesiyle eşleşen testleri bulmak veya çalıştırmak için VSTest filtreleme mekanizmasını kullanma olanağı da sunar. Daha fazla bilgi için Filtre seçeneği ayrıntıları bölümüne veya çerçeveye özgü ayrıntılar için seçmeli birim testlerini çalıştırma sayfasına bakın.

Test çerçevesi tarafından etkinleştirildiğinde --filter <FILTER_EXPRESSION>kullanabilirsiniz.

TestRun parametreleri

--test-parameterbiçimindeki key=value komut satırı seçeneğini kullanarak parametreleri test çalıştırmasına geçirebilirsiniz. Bu seçenek, ayarlanacak her parametre için bir tane olmak üzere birden çok kez belirtilebilir.

Bu parametrelere test çalıştırmasında test çerçevesi tarafından erişilebilir:

• MSTest için Properties kullanın
• NUnit için TestContext.TestParameters kullanın