Test Gezgini'ni kullanarak birim testleri çalıştırma

Visual Studio'dan veya üçüncü taraf birim testi projelerinden birim testleri çalıştırmak için Test Gezgini'ni kullanın. Test Gezgini'nde testleri kategoriler halinde gruplandırabilir, test listesini filtreleyebilir ve test çalma listeleri oluşturabilir, kaydedebilir ve çalıştırabilirsiniz. Test Gezgini'ni, birim testlerinde hata ayıklamak için ve Visual Studio Enterprise'da kod kapsamını analiziçin de kullanabilirsiniz.

Test Gezgini, bir çözümdeki birden çok test projesinden ve üretim kodu projelerinin parçası olan test sınıflarından testleri çalıştırabilir. Test projeleri çeşitli birim testi çerçeveleri kullanabilir. Test altındaki kod .NET için yazıldığında, test projesi hedef kodun dilinden bağımsız olarak .NET'i de hedefleyen herhangi bir dilde yazılabilir. C++ birim testi çerçevesi kullanarak yerel C ve C++ kod projelerini test etmeniz gerekir.

Test projenizi oluşturma

Visual Studio çözümünüzde önceden ayarlanmış bir test projeniz yoksa, önce bir test projesi oluşturup oluşturmanız gerekir. Şu kaynakları kullanın:

• Birim testi (.NET) kullanmaya başlama
• C/C++ için birim testleri yazma

Visual Studio hem yönetilen hem de yerel kod için Microsoft birim testi çerçevelerini içerir. Ancak Test Gezgini, Test Gezgini bağdaştırıcısını uygulayan herhangi bir birim testi çerçevesini de çalıştırabilir. Üçüncü taraf birim testi çerçevelerini yükleme hakkında daha fazla bilgi için bkz. birim testi çerçevelerini yükleme.

Test Gezgini'nde testleri çalıştırma

Test projesini oluşturduğunuzda, testler Test Gezgini'nde görünür. Test Gezgini görünmüyorsa Visual Studio menüsünde test seçin ve ardından Test Gezgini seçin (veya Ctrl+E, T'yi seçin).

Testlerinizi çalıştırırken, yazarken ve yeniden çalıştırırken, Test Gezgini sonuçları varsayılan Project, Ad Alanıve Sınıfgruplandırmalarında görüntüler. Test Gezgini'nin testlerinizi gruplandırma şeklini değiştirebilirsiniz.

Test Gezgini araç çubuğundan testleri bulma, düzenleme ve çalıştırma işlemlerinin büyük bir kısmını gerçekleştirebilirsiniz.

Testleri çalıştırma

Testleri çalıştırmak için şu seçeneklerden birini belirleyin:

• Bir çözümdeki tüm testleri çalıştırmak için, Tümünü Çalıştır simgesini seçin (veya Ctrl+R, V'yi seçin).

• Tüm testleri varsayılan bir grupta çalıştırmak için Çalıştır simgesini ve ardından menüden grubu seçin.

• Tek tek testleri çalıştırmak için bir veya daha fazla test seçin, bölmede bir yere sağ tıklayın ve ardından Seçili Testleri Çalıştır seçin (veya Ctrl+R, T'yi seçin).

  Tek tek testlerin herhangi bir sırada çalıştırılmasını engelleyen bağımlılıkları yoksa, araç çubuğunun ayarlar menüsünde paralel test yürütmeyi açın. Bu eylem tüm testleri çalıştırma süresini kısaltabilir.

Not

Birim testlerini çalıştırmak üzere hedef platformu (işlem mimarisi) yapılandırmak için bkz. Birim testi için işlem mimarisini yapılandırma.

Her derlemeden sonra testleri çalıştırma

Her yerel derlemeden sonra birim testlerinizi çalıştırmak için, Test Gezgini araç çubuğunda ayarlar simgesini seçin ve ardından derlemeden sonra testleri çalıştırseçeneğini seçin.

Test sonuçlarını görüntüleme

Testlerinizi çalıştırırken, yazarken, yeniden çalıştırırken, Test Gezgini, sonuçları Başarısız Testler, Geçen Testler, Atlanan Testlerve Çalıştırılmayan Testlergruplarında görüntüler. Test Gezgini'nin alt veya yan kısmındaki ayrıntılar bölmesinde test yürütmesinin özeti görüntülenir.

Test ayrıntılarını görüntüleme

Tek bir testin ayrıntılarını görüntülemek için testi seçin.

Test ayrıntıları bölmesi şu şekilde görüntülenir:

• Kaynak dosya adı ve test yönteminin satır numarası.

• Testin durumu.

• Test yönteminin çalışması için geçen süre.

Test başarısız olursa ayrıntılar bölmesi de görüntülenir:

• Birim testi çerçevesinin test için döndürdüğü ileti.

• Testin başarısız olduğu sırada yığın izlemesi.

Test yönteminin kaynak kodunu görüntüleme

Visual Studio düzenleyicisinde bir test yönteminin kaynak kodunu görüntülemek için teste sağ tıklayın ve ardından Test Aç seçin (veya F12 tuşunu seçin).

Test listesini gruplandırma ve filtreleme

Test Gezgini'nde testlerinizi önceden tanımlanmış kategoriler halinde gruplandırabilirsiniz. Test Gezgini'nde çalışan birim testi çerçevelerinin çoğu, testlerinizi gruplandırmak için kendi kategorilerinizi ve kategori/değer çiftlerinizi tanımlamanıza olanak tanır. Dizeleri test özellikleriyle eşleştirerek test listesini de filtreleyebilirsiniz.

Test listesindeki testleri gruplandırma

Test Gezgini, testlerinizi bir hiyerarşide gruplandırmanıza olanak tanır. Varsayılan hiyerarşi gruplandırma Project, Ad Alanıve ardından Sınıf . Testlerin düzenlenme biçimini değiştirmek için önce Gruplandır düğmesini, sonra seçin ve ardından yeni bir gruplandırma ölçütü belirleyin.

Gruplandırma seçeneklerini (Sırala) tercih ettiğiniz sıraya göre seçerek kendi hiyerarşi düzeylerinizi tanımlayabilirsiniz (örneğin, Durum ve ardından Sınıfşeklinde gruplandırın).

Test Gezgini grupları

Grup	Açıklama
Süre	Testleri yürütme süresine göre gruplandırma: Hızlı, OrtaYavaş.
State	Testleri yürütme sonuçlarına göre gruplandırma: Başarısız Testler, Atlanan Testler, Geçirilen Testler Çalıştırılmıyor.
Hedef Çerçeve	Testleri, projelerinin hedeflediği çerçeveye göre gruplandırın.
Ad Alanı	Testleri içeren ad alanına göre gruplandırın.
Proje	Testleri içeren projeye göre gruplandırın.
Sınıfı	Testleri içeren sınıfa göre gruplandırın.

Özellik

Özellik genellikle bir kategori adı/değer çiftidir, ancak tek bir kategori de olabilir. Özellikler, birim test çerçevesinin test yöntemleri olarak tanımladığı yöntemlere atanabilir.

Birim testi çerçevesi, özellik kategorilerini tanımlayabilir. Kendi kategori adınızı/değer çiftlerinizi tanımlamak için özellik kategorilerine değerler ekleyebilirsiniz. Birim testi çerçevesi, özellik kategorilerini ve değerlerini belirtmek için söz dizimini tanımlar.

Yönetilen Kod için Microsoft Unit Testing Framework'teki Özellikler

Yönetilen Kod için Microsoft Unit Testing Framework'te, TestPropertyAttribute özniteliğinde bir özellik adı/değer çifti tanımlarsınız. Test çerçevesi şu önceden tanımlanmış özellikleri de içerir:

Özellik	Açıklama
OwnerAttribute	Owner kategorisi birim testi çerçevesi tarafından tanımlanır ve sahibin dize değerini sağlamanız gerekir.
PriorityAttribute	Priority kategorisi birim test çerçevesi tarafından tanımlanır ve önceliğin tamsayı değerini sağlamanız gerekir.
TestCategoryAttribute	TestCategory özniteliği, birim testinin kategorisini belirtmenizi sağlar.
TestPropertyAttribute	TestProperty özniteliği, bir özellik kategorisi/değer çifti tanımlamanızı sağlar.

C++ için Microsoft Unit Testing Framework'teki Özellikler

Bkz. Visual Studio'de C++ için Microsoft Unit Testing Framework kullanma.

Özel çalma listeleri oluşturma

Grup olarak çalıştırmak veya görüntülemek istediğiniz testlerin listesini oluşturabilir ve kaydedebilirsiniz. Bir çalma listesi seçtiğinizde, listedeki testler yeni bir Test Gezgini sekmesinde görünür. Birden fazla çalma listesine test ekleyebilirsiniz.

Çalma listesi oluşturmak için:

1. Test Gezgini'nde bir veya daha fazla test seçin.
2. Bölmede bir yere sağ tıklayın, Çalma Listesine Ekleüzerine gelin ve Yeni Çalma Listesiseçin.

Çalma listesi yeni bir Test Gezgini sekmesinde açılır. Bu çalma listesini bir kez kullanabilir ve ardından atabilirsiniz. İsterseniz, çalma listesi penceresinin araç çubuğundaki Kaydet düğmesini seçebilir ve ardından çalma listesini kaydetmek için bir ad ve konum seçebilirsiniz.

Çalma listesini açmak için:

1. Visual Studio araç çubuğunda çalma listesi simgesini seçin.
2. Menüde, önceden kaydedilmiş bir çalma listesi dosyasını seçin.

Çalma listesini düzenlemek için şu seçeneklerden birini kullanın:

• Herhangi bir teste sağ tıklayın ve ardından menü komutlarını kullanarak bir çalma listesi ekleyin veya kaldırın.

• Araç çubuğunda Çalma Listesini Düzenle düğmesini seçin. Testlerinizin yanında gösterilen onay kutuları, çalma listesine hangi testlerin dahil olduğunu ve hariç tutulduğunu gösterir. Grupları istediğiniz gibi düzenleyin. Bu özellik Visual Studio 2019 sürüm 16.7'de başladı.

  

Hiyerarşideki ebeveyn grupların kutularını da seçebilir veya temizleyebilirsiniz. Bu eylem, bu gruptaki testlere göre çalma listesini her zaman güncelleştiren dinamik bir çalma listesi oluşturur.

Örneğin, bir sınıfın yanındaki onay kutusunu seçerseniz, o sınıftan eklenen tüm testler bu çalma listesinin bir parçası olur. Bu sınıftan bir testi silerseniz, bu test çalma listesinden kaldırılır.

Araç çubuğundaki Kaydet düğmesini kullanarak çalma listesini kaydedip diskinizde oluşturulan .playlist XML dosyasını açarak kurallar hakkında daha fazla bilgi edinebilirsiniz. Bu dosya, bir çalma listesini oluşturan tüm kuralları ve tek tek testleri listeler.

Özellikler için bir çalma listesi oluşturmak istiyorsanız, MSTest çerçevesi için aşağıdaki biçimi kullanın:

<Playlist Version="2.0">
  <Rule Name="Includes" Match="Any">
    <Property Name="Trait" Value="SchemaUpdateBasic" />
  </Rule>
</Playlist>

xUnit çerçevesi için aşağıdaki biçimi kullanın. TestCategory adınız ile [Value] değeri arasında bir boşluk olduğundan emin olun.

<Playlist Version="2.0">
  <Rule Name="Includes" Match="Any">
    <Rule Match="All">
      <Property Name="Solution" />
        <Rule Match="Any">
            <Property Name="Trait" Value="TestCategory [Value]" />
        </Rule>
    </Rule>
  </Rule>
</Playlist>

Test Gezgini sütunları

Grupları, Traits, Stack Trace, Hata Mesajıve Tam Nitelikli Adile birlikte Test Gezgini'nde sütun olarak da kullanılabilir. Sütunların çoğu varsayılan olarak görünmez. Hangi sütunların görüneceğini özelleştirebilirsiniz.

Sütunlar filtrelenebilir, yeniden düzenlenebilir ve sıralanabilir:

• Belirli özelliklere göre filtrelemek için Özellikler sütununun üst kısmındaki filtre simgesini seçin.

  

• Sütunların sırasını değiştirmek için bir sütun başlığı seçin ve sola veya sağa sürükleyin.

• Sütunu sıralamak için sütun başlığını seçin. Tüm sütunlar sıralanamaz. Shift tuşunu basılı tutarak ve ek bir sütun üst bilgisi seçerek ikincil bir sütuna göre de sıralama yapabilirsiniz.

  

Test listesini arama ve filtreleme

Ayrıca, görüntüleyip çalıştırdığınız projelerinizdeki test yöntemlerini sınırlamak için Test Gezgini arama filtrelerini de kullanabilirsiniz.

Test Gezgini arama kutusuna bir dize yazdığınızda ve Enter tuşunu seçtiğinizde, test listesi yalnızca tam adları dizeyi içeren testleri gösterecek şekilde filtrelenmiş olur.

Farklı bir ölçüte göre filtrelemek için:

1. Arama kutusunun sağındaki açılan listeyi açın.

2. Yeni bir ölçüt seçin.

3. Tırnak işaretlerinin arasına filtre değerini girin. Dizede eşleşme içeren bir eşleşme yerine tam eşleşme aramak istiyorsanız, iki nokta üst üste (:)) yerine eşittir işareti (=) kullanın.

Not

Aramalar büyük/küçük harfe duyarlı değildir ve belirtilen dizeyi ölçüt değerinin herhangi bir bölümüyle eşleştirir.

Niteleyici	Açıklama
State	Test Gezgini kategori adlarını eşleşmeler için arar: Başarısız Testler, Atlanan TestlerGeçirilen Testler.
Özellikler	Eşleşmeler için hem özellik kategorilerini hem de değerleri arar. Birim testi çerçevesi, özellik kategorilerini ve değerlerini belirtmek için söz dizimini tanımlar.
Tam Nitelikli İsim	Eşleşmeler için test ad alanlarının, sınıfların ve yöntemlerin tam adını arar.
Proje	Test proje adlarında eşleşmeleri arar.
Hedef Çerçeve	Test çerçevelerinde eşleşmeleri arar.
Ad Alanı	Test ad alanlarının eşleşmelerini arar.
Sınıfı	Test sınıfı adlarında eşleşme arar.

Filtre sonuçlarının bir alt kümesini dışlamak için aşağıdaki söz dizimini kullanın:

FilterName:"Criteria" -FilterName:"SubsetCriteria"

Örneğin, FullName:"MyClass" - FullName:"PerfTest", adında "MyClass" bulunan, ancak adında "PerfTest" bulunmayan tüm testleri döndürür.

Birim testi kod kapsamını analiz et

Visual Studio Enterprise'da bulunan Visual Studio Code kapsam aracını kullanarak birim testlerinizin gerçekten test ettiği ürün kodu miktarını belirleyebilirsiniz. Kod kapsamını seçili testlerde veya çözümdeki tüm testlerde çalıştırabilirsiniz.

Bir çözümde test yöntemleri için kod kapsamını çalıştırmak için:

• Test Gezgini'nde sağ tıklayın ve ardından Seçili testler için Kod Kapsamını Analiz Etseçin.

Kod Kapsamı Sonuçları penceresi, satır, işlev, sınıf, ad alanı ve modül tarafından işlenen ürün kodu bloklarının yüzdesini gösterir.

Daha fazla bilgi için bkz. ne kadar kodun test edildiğini belirlemek için kod kapsamını kullanma.

Test kısayolları

Test Gezgini'nden aşağıdakilerden birini yaparak testleri çalıştırabilirsiniz:

• Kod düzenleyicisinde bir teste sağ tıklayıp ardından Testi çalıştır seçeneğini seçin
• Visual Studio'da varsayılan Test Gezgini kısayolları kullanma

Kısayollardan bazıları bağlam tabanlıdır. İmlecinizin kod düzenleyicisinde nerede olduğuna bağlı olarak, hata ayıklama,test çalıştırma veya profil yürütme işlemlerini gerçekleştirirler. İmleciniz bir test yönteminin içindeyse, bu test yöntemi çalışır. İmleciniz sınıf düzeyindeyse, o sınıftaki tüm testler çalıştırılır. Ad alanı düzeyi için de aynı davranış geçerlidir.

Sık kullanılan komutlar	Klavye kısayolları
TestExplorer.DebugAllTestsInContext	Ctrl+R, Ctrl+T
TestExplorer.RunAllTestsInContext	Ctrl+R, T
TestExplorer.RunAllTests	Ctrl+R, A
TestExplorer.RepeatLastRun	Ctrl+R, L

Not

Testler yalnızca soyut sınıflarda tanımlandığından ve örneklenmediğinden, soyut sınıfta test çalıştıramazsınız. Soyut sınıflarda testleri çalıştırmak için soyut sınıftan türetilen bir sınıf oluşturun.

Sesli ipuçlarını ayarlama

Bir test çalıştırması tamamlandığında Test Gezgini şu seslerden birini çalabilir:

• Test çalıştırmasının tüm geçiş testleriyle başarılı olduğunu gösteren ses
• Test çalıştırmasının en az bir başarısız testle tamamlandığını gösteren ses

Bu sesleri varsayılan Windows 11 Ses iletişim kutusunda ayarlayabilirsiniz. Bu özellik Visual Studio 2019 Güncelleştirme 16.9 Önizleme 3'te kullanıma sunulmuştur.

1. Varsayılan Windows 11 Ses iletişim kutusunu açın.
2. Sesler sekmesine gidin.
3. Microsoft Visual Studio kategorisini bulun. Test Çalıştırması Başarılı veya Test Çalıştırması Başarısız önceden ayarlanmış sesi seçin ya da kendi ses dosyanıza göz atabilirsiniz.

İlgili içerik

• Kodunuzu birim testine tabi tutun
• Test Gezgini ile birim testlerini hata ayıklama
• Birim testlerini 64 bit işlem olarak çalıştırma
• Test Gezgini Hakkında SSS