Live Unit Testing kullanmaya başlama

bir Visual Studio çözümünde Live Unit Testing etkinleştirdiğinizde, test kapsamınız ve testlerinizin durumunu görsel olarak gösterir. Live Unit Testing Ayrıca, kodunuzun her değişiklik yaptığınızda testleri dinamik olarak yürütür ve değişiklikleriniz testlerin başarısız olmasına neden olduğunda sizi anında bilgilendirir.

Live Unit Testing, .NET Framework ya da .net Core ' u hedefleyen çözümleri test etmek için kullanılabilir. Bu öğreticide, .NET Standard hedefleyen basit bir sınıf kitaplığı oluşturarak Live Unit Testing kullanacağınızı öğrenirsiniz ve test etmek üzere .NET Core 'u hedefleyen bir MSTest projesi oluşturacaksınız.

Tam C# çözümü, GitHub microsoftdocs/VisualStudio-docs deposundan indirilebilir.

Önkoşullar

bu öğreticide, .net Core platformlar arası geliştirme iş yüküne Visual Studio Enterprise edition sürümünü yüklemiş olmanız gerekir.

Çözüm ve sınıf kitaplığı projesi oluşturma

tek bir .NET Standard sınıf kitaplığı projesi olan stringlibrary ' den oluşan bir Visual Studio çözümü oluşturarak başlayın.

Çözüm yalnızca bir veya daha fazla proje için bir kapsayıcıdır. boş bir çözüm oluşturmak için Visual Studio açın ve aşağıdakileri yapın:

1. üst düzey Visual Studio menüsünden dosya yeni Project seçin.

2. Şablon arama kutusuna çözüm yazın ve ardından boş çözüm şablonunu seçin. Projenin kullanımı Tylibraries olarak adlandırın.

   

3. Çözümü oluşturmayı tamamlama.

Çözümü oluşturduğunuza göre, dizeler ile çalışmak için birkaç uzantı yöntemi içeren StringLibrary adlı bir sınıf kitaplığı oluşturacaksınız.

1. Çözüm Gezgini' de, kullanımı, ek yazım kitaplıkları çözümüne sağ tıklayın ve > yeni Project ekle ' yi seçin.

5. Kod düzenleyicisinde varolan tüm kodu aşağıdaki kodla değiştirin:

   using System;
   
   namespace UtilityLibraries
   {
       public static class StringLibrary
       {
           public static bool StartsWithUpper(this string s)
           {
               if (String.IsNullOrWhiteSpace(s))
                   return false;
   
               return Char.IsUpper(s[0]);
           }
   
           public static bool StartsWithLower(this string s)
           {
               if (String.IsNullOrWhiteSpace(s))
                   return false;
   
               return Char.IsLower(s[0]);
           }
   
           public static bool HasEmbeddedSpaces(this string s)
           {
               foreach (var ch in s.Trim())
               {
                   if (ch == ' ')
                       return true;
               }
               return false;
           }
       }
   }
   

   StringLibrary üç statik yönteme sahiptir:

   • StartsWithUpper``truebir dize, büyük harfle başlıyorsa döndürür; Aksi takdirde, döndürür false .

   • StartsWithLower``truebir dize küçük harf karakteriyle başlıyorsa döndürür; Aksi takdirde, döndürür false .

   • HasEmbeddedSpaces``truebir dize gömülü bir boşluk karakteri içeriyorsa döndürür; Aksi takdirde, döndürür false .

6. üst düzey Visual Studio menüsünden build build Solution öğesini seçin. Derleme başarılı olmalıdır.

Test projesi oluşturma

Sonraki adım, StringLibrary kitaplığını test etmek için birim test projesi oluşturmaktır. Aşağıdaki adımları gerçekleştirerek birim testlerini oluşturun:

1. Çözüm Gezgini' de, kullanımı, ek yazım kitaplıkları çözümüne sağ tıklayın ve > yeni Project ekle ' yi seçin.

5. Birim testi projesi test edilen sınıf kitaplığına otomatik olarak erişemez. Sınıf kitaplığı projesine bir başvuru ekleyerek test Kitaplığı erişimi verirsiniz. Bunu yapmak için projeye sağ tıklayın StringLibraryTests ve başvuru Ekle ' yi seçin > . Başvuru Yöneticisi iletişim kutusunda, çözüm sekmesinin seçili olduğundan emin olun ve aşağıdaki çizimde gösterildiği gibi StringLibrary projesini seçin.

   

6. Şablon tarafından sunulan ortak birim test kodunu şu kodla değiştirin:

   using System;
   using Microsoft.VisualStudio.TestTools.UnitTesting;
   using UtilityLibraries;
   
   namespace StringLibraryTest
   {
       [TestClass]
       public class UnitTest1
       {
           [TestMethod]
           public void TestStartsWithUpper()
           {
               // Tests that we expect to return true.
               string[] words = { "Alphabet", "Zebra", "ABC", "Αθήνα", "Москва" };
               foreach (var word in words)
               {
                   bool result = word.StartsWithUpper();
                   Assert.IsTrue(result,
                                 $"Expected for '{word}': true; Actual: {result}");
               }
           }
   
           [TestMethod]
           public void TestDoesNotStartWithUpper()
           {
               // Tests that we expect to return false.
               string[] words = { "alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                                  "1234", ".", ";", " " };
               foreach (var word in words)
               {
                   bool result = word.StartsWithUpper();
                   Assert.IsFalse(result,
                                  $"Expected for '{word}': false; Actual: {result}");
               }
           }
   
           [TestMethod]
           public void DirectCallWithNullOrEmpty()
           {
               // Tests that we expect to return false.
               string[] words = { String.Empty, null };
               foreach (var word in words)
               {
                   bool result = StringLibrary.StartsWithUpper(word);
                   Assert.IsFalse(result,
                                  $"Expected for '{(word == null ? "<null>" : word)}': " +
                                  $"false; Actual: {result}");
               }
           }
       }
   }
   

7. Araç çubuğundaki Kaydet simgesini seçerek projenizi kaydedin.

   Birim test kodu bazı ASCII olmayan karakterler içerdiğinden, dosyayı varsayılan ASCII biçiminde kaydederseniz bazı karakterlerin kaybolacağını uyarmak için aşağıdaki iletişim kutusunu görürsünüz.

8. Diğer kodlamaya sahip Kaydet düğmesini seçin.

   

9. Aşağıdaki çizimde gösterildiği gibi, Gelişmiş kaydetme seçenekleri Iletişim kutusunun kodlama açılan LISTESINDE Unicode (imzasız UTF-8)-kod sayfası 65001' ı seçin:

   

10. üst düzey Visual Studio menüsünden derleme yeniden oluşturma çözümünü seçerek birim testi projesini derleyin.

Bir sınıf kitaplığı ve bunun için bazı birim testlerini oluşturdunuz. Artık Live Unit Testing kullanmak için gereken başlangıç kuralları tamamladınız.

Live Unit Testing etkinleştir

Şimdiye kadar, StringLibrary sınıf kitaplığı için testleri yazmış olsanız da onları çalıştırmadınız. Live Unit Testing, bunları etkinleştirdikten sonra otomatik olarak yürütür. Bunu yapmak için aşağıdakileri yapın:

1. İsteğe bağlı olarak, StringLibrary kodunu içeren kod düzenleyici penceresini seçin. bu, bir C# projesi için class1. cs veya bir Visual Basic projesi için class1. vb ' dir. (Bu adım, Live Unit Testing etkinleştirdikten sonra testlerinizin sonucunu ve kod kapsamınız kapsamını görsel olarak incelemenize olanak sağlar.)

2. en üst düzey Visual Studio menüsünden Test Live Unit Testing başlat ' ı seçin.

3. Visual Studio, tüm testlerinizi otomatik olarak çalıştıran canlı birim testi başlatır.

Ayrıca, kod Düzenleyicisi penceresinde belirli bir kod kapsamı simgesini seçerek test kapsamı ve test sonuçları hakkında daha ayrıntılı bilgi edinebilirsiniz. Bu ayrıntıyı incelemek için aşağıdakileri yapın:

1. Yönteminde okuyan satırdaki yeşil onay işaretine tıklayın if (String.IsNullOrWhiteSpace(s)) StartsWithUpper . Aşağıdaki çizimde gösterildiği gibi, Live Unit Testing üç testin bu kod satırını kapsadığını ve tümünün başarıyla yürütüldüğünü gösterir.

   

2. Yönteminde okuyan satırdaki yeşil onay işaretine tıklayın return Char.IsUpper(s[0]) StartsWithUpper . Aşağıdaki çizimde gösterildiği gibi Live Unit Testing yalnızca iki testin bu kod satırına sahip olduğunu ve tüm testlerin başarıyla yürütülmektedir.

   

Tanımlanmamış kod Live Unit Testing büyük sorun eksik kod kapsamıdır. Bunu bir sonraki bölümde ele alasiniz.

Test kapsamını genişletme

Bu bölümde birim testlerinizi yöntemine StartsWithLower genişletebilirsiniz. Bunu yaparken, Live Unit Testing dinamik olarak kodunuzu test etmeye devam eder.

Kod kapsamı yönteminin StartsWithLower kapsamına genişletmek için şunları yapın:

1. Projenizin TestStartsWithLower TestDoesNotStartWithLower test kaynak kodu dosyasına aşağıdaki ve yöntemlerini ekleyin:

   // Code to add to UnitTest1.cs
   [TestMethod]
   public void TestStartsWithLower()
   {
       // Tests that we expect to return true.
       string[] words = { "alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство" };
       foreach (var word in words)
       {
           bool result = word.StartsWithLower();
           Assert.IsTrue(result,
                         $"Expected for '{word}': true; Actual: {result}");
       }
   }
   
   [TestMethod]
   public void TestDoesNotStartWithLower()
   {
       // Tests that we expect to return false.
       string[] words = { "Alphabet", "Zebra", "ABC", "Αθήνα", "Москва",
                          "1234", ".", ";", " "};
       foreach (var word in words)
       {
           bool result = word.StartsWithLower();
           Assert.IsFalse(result,
                          $"Expected for '{word}': false; Actual: {result}");
       }
   }
   

2. yöntemine DirectCallWithNullOrEmpty yapılan çağrıdan hemen sonra aşağıdaki kodu ekleyerek yöntemini Microsoft.VisualStudio.TestTools.UnitTesting.Assert.IsFalse değiştirme.

   // Code to add to UnitTest1.cs
   result = StringLibrary.StartsWithLower(word);
   Assert.IsFalse(result,
                  $"Expected for '{(word == null ? "<null>" : word)}': " +
                  $"false; Actual: {result}");
   

3. Live Unit Testing kodunuzu değiştirerek yeni ve değiştirilmiş testleri otomatik olarak yürütür. Aşağıdaki çizimde gösterildiği gibi, eklemış olduğunuz ikisi ve değiştirdklerinden biri de dahil olmak üzere tüm testler başarılı oldu.

   

   

4. StringLibrary sınıfının kaynak kodunu içeren pencereye geçiş. Live Unit Testing kod kapsamımızın yöntemine genişletildi olduğunu StartsWithLower gösteriyor.

   

Bazı durumlarda Test Gezgini'nde başarılı testler gri olabilir. Bu, bir testin yürütültülürken olduğunu veya son yürütülürken testi etkileyen bir kod değişikliği olmadığını çünkü testin yeniden çalıştırılamay olmadığını gösterir.

Şimdiye kadar tüm testlerimiz başarılı oldu. Sonraki bölümde test hatalarını nasıl işleyebilirsiniz?

Test hatalarını işleme

Bu bölümde test hatalarını tanımlamak, gidermek ve Live Unit Testing için bu Live Unit Testing nasıl kullanabileceğiniz hakkında bilgi edinebilirsiniz. Bunu yapmak için test kapsamını yöntemine HasEmbeddedSpaces genişletebilirsiniz.

1. Test dosyanıza aşağıdaki yöntemi ekleyin:

   [TestMethod]
   public void TestHasEmbeddedSpaces()
   {
       // Tests that we expect to return true.
       string[] phrases = { "one car", "Name\u0009Description",
                            "Line1\nLine2", "Line3\u000ALine4",
                            "Line5\u000BLine6", "Line7\u000CLine8",
                            "Line0009\u000DLine10", "word1\u00A0word2" };
       foreach (var phrase in phrases)
       {
           bool result = phrase.HasEmbeddedSpaces();
           Assert.IsTrue(result,
                         $"Expected for '{phrase}': true; Actual: {result}");
       }
   }
   

2. Test yürütülürken Live Unit Testing yöntemin başarısız TestHasEmbeddedSpaces olduğunu gösterir. Aşağıdaki çizimde gösterildiği gibi:

   

   

3. Kitaplık kodunu görüntüleyen pencereyi seçin. Live Unit Testing kapsamı yöntemine HasEmbeddedSpaces genişletti. Ayrıca başarısız olan testlerin kapsamına alınan satırlara kırmızı 🞩 " " ekleyerek test hatalarını raporlar.

4. Metot imzası olan satırın HasEmbeddedSpaces üzerine gelin. Live Unit Testing, aşağıdaki çizimde gösterildiği gibi yöntemin bir test kapsamında olduğunu rapor eden bir araç ipucu görüntüler:

   

5. Başarısız TestHasEmbeddedSpaces testini seçin. Live Unit Testing, aşağıdaki çizimde gösterildiği gibi tüm testleri çalıştırma ve tüm testlerde hata ayıklama gibi birkaç seçenek sunar:

   

   

6. Başarısız testte hata ayıklamak için Tüm Hata Ayıkla'ya seçin.

7. Visual Studio hata ayıklama modunda yürütür.

   Test, dizide yer alan her dizeyi adlı bir değişkene atar phrase ve yöntemine HasEmbeddedSpaces iletir. Program yürütmesi, onay ifadesi ilk kez olduğu zaman duraklatılır ve hata ayıklayıcıyı false çağırır. Yöntem çağrısında beklenmeyen değerden sonuç alan özel Microsoft.VisualStudio.TestTools.UnitTesting.Assert.IsTrue durum iletişim kutusu aşağıdaki çizimde gösterilmiştir.

   

   Ayrıca, aşağıdaki çizimde gösterildiği gibi Visual Studio hata ayıklama araçlarının hepsi başarısız testimizin sorunlarını gidermemize yardımcı olmak için kullanılabilir:

   

   Otomatikler penceresinde değişkenin değerinin dizinin ikinci öğesi olan phrase "Name\tDescription" olduğunu unutmayın. Test yöntemi, bu HasEmbeddedSpaces dize true geçiriken dönüş bekler; bunun yerine false döndürür. Görünen o ki sekme karakteri olan "\t" karakterini ekli alan olarak tanımaz.

8. Devamında Hata > Ayıkla'yı seçin, F5 tuşuna basın veya test programını yürütmeye devam etmek için araç çubuğundaKi Devam düğmesine tıklayın. İşlenemeyen bir özel durum meydana geldiği için test sonlandırılır. Bu, hatanın ön araştırması için yeterli bilgi sağlar. (Test TestHasEmbeddedSpaces yordamı) yanlış bir varsayımda bulundu HasEmbeddedSpaces veya tüm ekli alanları doğru şekilde tanımıyor.

9. Sorunu tanılamak ve düzeltmek için yöntemiyle StringLibrary.HasEmbeddedSpaces çalışmaya başlamanız gerekir. yönteminde karşılaştırmaya HasEmbeddedSpaces bakın. Ekli bir alanı U+0020 olarak kabul ediyor. Ancak, Unicode Standart bir dizi başka boşluk karakteri içerir. Bu, kitaplık kodunun yanlış bir şekilde boşluk karakteri için test edilmiş olduğunu önerir.

10. Eşitlik karşılaştırmasını yöntemine yapılan bir çağrıyla System.Char.IsWhiteSpace değiştirin:

    if (Char.IsWhiteSpace(ch))
    

11. Live Unit Testing başarısız test yöntemini otomatik olarak yeniden çalıştırıyor.

    Live Unit Testing, kod düzenleyicisi penceresinde de görünen güncelleştirilmiş sonuçları gösterir.

Ayrıca bkz.

• Live Unit Testing Visual Studio
• Live Unit Testing Sorulan Sorular