Konfigurace a používání Live Unit Testing

Při vývoji aplikace Live Unit Testing automaticky spustí všechny ovlivněné jednotkové testy na pozadí a zobrazí výsledky a pokrytí kódu v reálném čase. Při úpravě kódu poskytuje Live Unit Testing zpětnou vazbu k tomu, jak vaše změny ovlivnily stávající testy a jestli je nový kód, který jste přidali, pokryt jedním nebo více existujícími testy. Tato zpětná vazba vám připomene, abyste při opravách chyb nebo přidávání nových funkcí psali jednotkové testy.

Pokud pro testy používáte Live Unit Testing, uchovává data o stavu vašich testů. Použití trvalých dat umožňuje live Unit Testing nabídnout vynikající výkon při dynamickém spouštění testů v reakci na změny kódu.

Live Unit Testing je k dispozici pouze v edici Enterprise sady Visual Studio pro projekty, které cílí na .NET Core nebo .NET Framework.

Podporované testovací architektury

Live Unit Testing funguje se třemi oblíbenými architekturami testování jednotek uvedenými v následující tabulce. Zobrazuje se také minimální podporovaná verze adaptérů a architektur. Všechny architektury testování jednotek jsou dostupné z NuGet.org.

Testovací architektura	Minimální verze adaptéru sady Visual Studio	Minimální verze frameworku
xUnit.net	xunit.runner.visualstudio verze 2.2.0-beta3-build1187	xunit 1.9.2
NUnit	NUnit3TestAdapter verze 3.5.1	NUnit verze 3.5.0
MSTest	MSTest.TestAdapter 1.1.4-preview	MSTest.TestFramework 1.0.5-preview

Pokud máte starší projekty testů založené na MSTest, které odkazují na Microsoft.VisualStudio.QualityTools.UnitTestFramework a nechcete přejít na novější balíčky MSTest NuGet, upgradujte na Visual Studio 2019 nebo Visual Studio 2017.

V některých případech možná budete muset explicitně obnovit balíčky NuGet, na které projekt odkazuje, aby Live Unit Testing fungoval. Máte dvě možnosti:

• Provádějte obnovení explicitním sestavením řešení. V nabídce Visual Studio vyberte Sestavit>Znovu sestavit řešení.
• Obnovte softwarové balíčky v řešení. Klikněte pravým tlačítkem na řešení a vyberte Obnovit balíčky NuGet.

Konfigurujte

Při prvním spuštění Live Unit Testing pro řešení vám průvodce nastavením umožní nakonfigurovat způsob, jakým by živé testování částí mělo sestavovat a spouštět testy.

Pokud je testování živých jednotek zastaveno, můžete průvodce nastavením otevřít také tak, že přejdete do části Test>Live Unit Testing>Konfigurovat testování živých jednotek pro řešení.

Při spuštění Live Unit Testing vytvoří pracovní prostor, což je kopie původního úložiště. Live Unit Testing pak použije všechny neuložené změny, které jste v prostředí Visual Studio provedli v pracovním prostoru, provede sestavení, spustí testy a zobrazí nejnovější pokrytí kódu.

První věc, kterou byste měli nakonfigurovat pomocí průvodce, je místo, odkud se mají soubory zkopírovat a kam se mají zkopírovat.

Kořenový adresář úložiště

Kořenový adresář úložiště určuje složku, která se zkopíruje a vytvoří pracovní prostor Live Unit Testing. Měla by to být kořenová složka úložiště, to znamená, že by měla obsahovat všechny zdroje, binární soubory a nástroje. V případech, kdy soubor řešení není v kořenovém adresáři úložiště, může být potřeba změnit kořen úložiště.

Kořen pracovního prostoru

Kořenový adresář pracovního prostoru určuje složku, ve které Live Unit Testing uchovává klon úložiště. Dávejte pozor na výjimky, které značí, že cesta je příliš dlouhá. Ve výchozím nastavení se kořen vytvoří ve vaší domovské složce. Například pokud obvykle potřebujete vytvářet úložiště pod jednotkou C, může být kořen pracovního prostoru upraven na něco jako C:\lut\Repo.

Určení vyloučených souborů

Ne všechny soubory by se měly zkopírovat do pracovního prostoru Live Unit Testing. Všechny artefakty, které jsou generovány během sestavení, by měly být vyloučeny z kopírování, aby sestavení Live Unit Testing nebyla narušována běžnými sestaveními. nuget restore Běžný příkaz by také neměl kolidovat s příkazem Live Unit Testingnuget restore.

Live Unit Testing ve výchozím nastavení vyloučí jeden ze dvou vzorů souborů:

• V případě úložišť Git se soubory zadané v souboru Gitignore nekopírují do pracovního prostoru Live Unit Testing.
• V případě úložišť mimo Git se základní seznam složek, jako jsou bin/ a obj/, nekopírují do pracovního prostoru Live Unit Testing.

U složitějších úložišť možná budete muset zadat vlastní ignorovaný soubor. Vyberte v průvodci možnost "<Vlastní>". Po výběru možnosti Další se zobrazí obsah vlastního souboru ignorování, který Live Unit Testing vytvoří po dokončení průvodce. Je to soubor lutignore .

Poznámka:

Pro některá úložiště Git je potřeba vlastní soubor lutignore , protože je možné zkontrolovat soubory v úložišti Git, které jsou také ignorovány souborem gitignore . Bez vlastního souboru lutignore, Live Unit Testing tyto soubory nekopíruje, což může vést k selhání sestavení.

Struktura souborů Lutignore

Soubor lutignore používá stejný formát jako soubor Gitignore . Měla by obsahovat pravidla, která odpovídají složkám nebo souborům vygenerovaným během sestavení, aby se nekopírovaly do pracovního prostoru. U většiny výchozích šablon projektů stačí následující ignorovaný soubor:

[Bb]in
[Oo]bj
# WILL NOT COPY ANY BIN AND OBJ FOLDERS TO THE LIVE UNIT TESTING WORKSPACE

Pokud má vaše úložiště jednu složku sestavení, měl by soubor ignorovat místo toho tuto složku:

[Aa]rtifacts/
# WILL NOT COPY THE ARTIFACTS FOLDER TO THE LIVE UNIT TESTING WORKSPACE

Pokud vaše úložiště obsahuje některé další nástroje ve složce sestavení, měly by být tyto nástroje vyloučeny v sadě shodných vzorů:

[Aa]rtifacts/
![Aa]rtifacts/tools/
# WILL NOT COPY THE ARTIFACTS FOLDER TO THE LIVE UNIT TESTING WORKSPACE
# HOWEVER IT WILL COPY THE TOOLS SUBFOLDER THAT MIGHT CONTAIN TOOLS AND UTILITIES

Možnosti sestavení

Druhá část stránky konfigurace průvodce je místo, kde konfigurujete možnosti sestavení:

• Generování souborů PDB: Pokud chcete zrychlit sestavení, Live Unit Testing během sestavení nevygeneruje soubory PDB. Tyto soubory symbolů vám umožňují přejít na trasování zásobníku, když dojde k selhání testu.
• Sestavení pomocí více jader procesoru: Live Unit Testing ve výchozím nastavení provádí sestavení pomocí více jader procesoru, což zlepšuje dobu sestavení. Pokud se váš počítač zpomalí nebo pokud se vám nepodaří sestavit řešení pomocí více procesorů, tuto možnost nevybírejte.

Možnosti testovacího spuštění

Poslední část stránky konfigurace průvodce je místo, kde jste nastavili možnosti testovacího spuštění:

• Časový limit testovacího případu: Spuštění některých testů může trvat delší čas. Nastavení tohoto pole se automaticky přeruší, pokud některý z testů překročí určitou dobu trvání. Testy je možné automaticky zrušit.
• Použití více procesorů: Ve výchozím nastavení se Live Unit Testing pokusí použít více procesorů k urychlení výkonu spuštění. Pokud se počítač zpomalí nebo pokud vaše řešení nemůže paralelně spouštět testy, nevybírejte tuto možnost. K těmto scénářům může dojít například v případě, že se více testů pokusí zapisovat nebo číst ze stejných cest k souborům.

Další konfigurace

Live Unit Testing nakonfigurujte tak, že v řádku nabídek sady Visual Studio nejvyšší úrovně vybereteMožnosti>.

V podokně Možnosti rozbalte sekci Veškerá nastavení>Testování za běhu>jednotek.

Po povolení funkce Live Unit Testing (viz Start, Pause a stop Live Unit Testing) můžete znovu otevřít možnosti výběremmožnosti>>.

Mezi konfigurovatelné možnosti patří:

• Určuje, jestli live Unit Testing pozastaví, když je řešení sestavené a laděné.

• Zda Live Unit Testing pozastaví, když baterie systému klesne pod zadanou prahovou hodnotu.

• Možnost odstranit všechna trvalá data. Tato funkce je užitečná, když živé testování částí pracuje nepředvídatelným nebo neočekávaným způsobem, což naznačuje, že trvalá data jsou poškozená.

• Maximální množství paměti, kterou mohou využívat procesy Live Unit Testing.

• Úroveň informací zapsaných do okna Výstup pro Live Unit Testing.

  Mezi možnosti patří žádné protokolování (Žádné), pouze chybové zprávy (Chyba), chybové a informační zprávy (Informace, výchozí) nebo všechny podrobnosti (Podrobné).

  Podrobný výstup můžete také zobrazit v okně Výstup živého testování jednotek přiřazením hodnoty 1 k proměnné prostředí na úrovni uživatele s názvem VS_UTE_DIAGNOSTICS. Potom restartujte Visual Studio.

  Chcete-li zachytit podrobné zprávy protokolu MSBuild z Live Unit Testing v souboru, nastavte LiveUnitTesting_BuildLog proměnnou prostředí na úrovni uživatele na název souboru, který bude obsahovat protokol.

Přizpůsobit sestavení pro Live Unit Testing

V případě složitějších řešení může být nutné sestavení dále přizpůsobit. Například nemusí být nutné vytvářet soubory překladu během testovacích běhů. Chcete-li urychlit sestavení, můžete zakázat sestavení souboru překladu pomocí Live Unit Testing. Můžete to udělat tak, že budete manipulovat se soubory projektu.

Přidání nastavení pro Live Unit Testing

Pokud vaše řešení vyžaduje vlastní kroky sestavení pro instrumentaci (Live Unit Testing), které nejsou vyžadovány pro "běžné" neinstrumentované sestavení, můžete do projektu nebo souborů .targets přidat kód, který kontroluje BuildingForLiveUnitTesting vlastnost a provádí vlastní kroky před sestavením.

Můžete například napsat následující ukázku pro přidání dalšího cíle, který se spustí pouze pro Live Unit Testing:

<Target Name="GenerateNuGetPackages" BeforeTargets="AfterBuild" Condition="'$(BuildingForLiveUnitTesting)' == 'true'">
    <Exec Command='"$(MSBuildThisFileDirectory)..\tools\GenPac" '/>
</Target>

Vlastnost můžete použít BuildingForLiveUnitTesting k zakázání některých úloh, které by se neměly spouštět pro testovací sestavení. Například Live Unit Testing nastaví <RunAnalyzers>false</RunAnalyzers> na zakázání analyzátorů pro testy.

Živé testování jednotek závislosti testů

Je možné, že se nezkopírovaly všechny soubory, které jsou potřeba ke spuštění testů. Live Unit Testing vytvoří samostatnou složku, ve které spouští testy. Toto uspořádání umožňuje sestavení během spuštění testů, ale ne všechny soubory ze složky sestavení se zkopírují do testovací složky.

Obvykle přidáte závislosti testů z jednoho ze dvou důvodů:

• Testy závisí na souborech ve zdrojovém stromu. Testy například prověřují obsah souborů resx nebo možná čtou některé konfigurační soubory.
• Testy závisejí na některých knihovnách, které používají jako reference. Například test spustí spustitelný soubor vytvořený jako závislost.

Poznámka:

V adresáři určeném jako kořen úložiště v průvodci instalací musí existovat závislosti testů.

V obou případech Live Unit Testing ve výchozím nastavení tyto soubory nekopíruje za účelem minimalizace počtu souborů, které je potřeba zkopírovat ke spuštění testu. Tyto soubory musíte explicitně zadat pomocí LiveUnitTestingTestDependency vlastnosti, pokud jsou potřeba pro testovací běh. Řekněme například, že máme následující rozložení:

SRC/
  CONSOLE_UTILITY/
  TEST_PROJECT/
ARTIFACTS/
  CONSOLE_UTILITY/NET472/DEBUG/
  TEST_PROJECT/NET472/DEBUG/

Ve výchozím nastavení se při sestavování těchto projektů pomocí Live Unit Testing zkopíruje Artifacts/Test_Project pouze do testovací složky. Chcete-li přidat zdroje nebo console_utility do testovací složky, přidejte následující ukázku do test_project.csproj:

<LiveUnitTestingTestDependency Include=”$(RepoRoot)/Src/ConsoleUtility” />
<LiveUnitTestingTestDependency Include=”$(RepoRoot)/Artifacts/ConsoleUtility/net472/$(Configuration)/</LiveUnitTestingTestDependency” />

Zahájení, pozastavení a zastavení

Pokud chcete funkci Live Unit Testing povolit, vyberte Možnost Test>Live Unit Testing>Start v nabídce sady Visual Studio nejvyšší úrovně. Pokud je funkce Live Unit Testing povolená, možnosti dostupné v nabídce Live Unit Testing se změní z jediné položky, Start, na Pozastavit a Zastavit>:

• Pozastavením dočasně pozastavíte Live Unit Testing.

  Když je živé testování částí pozastavené, vizualizace pokrytí se v editoru nezobrazí, ale všechna shromážděná data se zachovají. Pokud chcete pokračovat v živém testování jednotek, vyberte Pokračovat v nabídce Live Unit Testing . Live Unit Testing provede potřebnou práci k zachycení všech úprav provedených během pozastavení a odpovídajícím způsobem aktualizuje glyfy.

• Zastavení úplně zastaví Live Unit Testing. Live Unit Testing zahodí všechna shromážděná data.

Pokud spustíte Live Unit Testing v řešení, které neobsahuje projekt testování jednotek, zobrazí se možnosti Pozastavení a zastavení v nabídce Live Unit Testing , ale Live Unit Testing se nespustí. V okně Výstup se zobrazí zpráva začínající textem: "Toto řešení neodkazuje na žádné podporované testovací adaptéry...".

Kdykoli můžete dočasně pozastavit nebo úplně zastavit Live Unit Testing. Tyto akce můžete například provést, pokud jste uprostřed refaktoringu a víte, že testy budou nějakou dobu přerušené.

Zahrnutí a vyloučení testovacích projektů a testovacích metod

Když spustíte Live Unit Testing, zobrazí se okno nástroje Live Unit Testing a zobrazí se výzva k výběru sady testů, které chcete testovat pomocí funkce Live Unit Testing.

V případě menších řešení, ve kterých testy jednotek zabírají velmi málo času, vyberte Zahrnout všechny testy, takže Live Unit Testing spustí všechny testy.

U větších řešení s mnoha testovacími projekty můžete určit, které projekty a jednotlivé metody v projektu se účastní Live Unit Testing úpravou seznamu úloh. Pokud máte například řešení se stovkami testovacích projektů, můžete vybrat cílovou sadu testovacích projektů, které se budou účastnit živého testování jednotek.

Můžete zvolit, které testy Live Unit Testing by se měly spouštět úpravou playlistu Live Unit Testing, což je funkce, která funguje stejně jako playlisty v Průzkumníku testů.

Seznam stop Live Unit Testing můžete upravit několika způsoby:

• Okno nástroje Live Unit Testing
• Okno editoru kódu
• Průzkumník řešení
• Pomocí programování v testovacím kódu

Live Unit Testing uloží stav zahrnutí/vyloučení jako nastavení uživatele a zapamatuje si ho při zavření a opětovném otevření řešení.

Live Unit Testing okno nástroje

Editor seznamu skladeb pro kartu Live Unit Testing můžete použít pro zahrnutí nebo vyloučení projektů, oborů názvů nebo tříd z vykonávání. V okně nástroje vyberte Upravit seznam stop .

Pokud chcete zahrnout nebo vyloučit testy, můžete vybrat nebo vymazat prvky stromového zobrazení. Pokud například provedete kontrolu jednoho testu, Live Unit Testing ho spustí při změnách. Pokud vyberete třídu, spustí se také všechny testy v této třídě a všechny nové testy přidané do této třídy.

Okno editoru kódu

Pomocí okna editoru kódu můžete zahrnout nebo vyloučit jednotlivé testovací metody. Klikněte pravým tlačítkem myši na podpis nebo text testovací metody v okně editoru kódu a vyberte jednu z následujících možností:

• Live Unit Testing>Zahrnout <vybranou metodu>
• Live Unit Testing>Vyloučit <vybranou metodu>
• Live Unit Testing>Vyloučit kromě <vybrané metody>

Průzkumník řešení

Pokud chcete vybrat jednotlivé projekty v jednotkových testech, postupujte po spuštění živého jednotkového testování takto:

1. Klikněte pravým tlačítkem myši na řešení v Průzkumníku řešení a vyberte Live Unit Testing>Vyloučit pro vyloučení celého řešení.
2. Pravým tlačítkem myši klikněte na každý testovací projekt, který chcete zahrnout do testů, a vyberte Live Unit Testing>Include.

Programově v testovacím kódu

Atribut můžete použít ExcludeFromCodeCoverageAttribute k programovému vyloučení metod, tříd nebo struktur z hlášení jejich pokrytí v Live Unit Testing.

Pomocí následujících atributů vyloučíte jednotlivé metody z Live Unit Testing:

• xUnit: [Trait("Category", "SkipWhenLiveUnitTesting")]
• NUnit: [Category("SkipWhenLiveUnitTesting")]
• MSTest: [TestCategory("SkipWhenLiveUnitTesting")]

K vyloučení celého sestavení testů z live Unit Testing použijte následující atributy:

• xUnit: [assembly: AssemblyTrait("Category", "SkipWhenLiveUnitTesting")]
• NUnit: [assembly: Category("SkipWhenLiveUnitTesting")]
• MSTest: [assembly: TestCategory("SkipWhenLiveUnitTesting")]

Zobrazení vizualizace pokrytí

Po povolení funkce Live Unit Testing aktualizuje každý řádek kódu v editoru sady Visual Studio, aby ukázal, jestli je kód, který právě píšete, pokryt testy jednotek a jestli testy, které ho pokrývají, procházejí.

Následující obrázek ukazuje řádky kódu s procházejícími a neúspěšnými testy a řádky kódu, které nejsou pokryty testy. Čáry se zelenou barvou "}" jsou pokryty pouze absolvováním testů. Řádky s červeným "x" obsahují jeden nebo více neúspěšných testů. Čáry s modrou "➖" nejsou pokryty žádným testem.

Vizualizace pokrytí Live Unit Testing se okamžitě aktualizuje při úpravě kódu v editoru kódu. Při zpracování úprav se vizualizace změní přidáním obrázku kulatého časovače pod symboly pro prošlé, neúspěšné a nepokryté, aby bylo zřejmé, že data nejsou aktuální, jak ukazuje následující obrázek.

Získání informací o stavu testu

Když najedete myší na předaný nebo neúspěšný symbol v okně kódu, uvidíte, kolik testů se na tento řádek dostane. Pokud chcete zobrazit stav jednotlivých testů, vyberte symbol.

Kromě zobrazení názvů a výsledků testů vám nástrojová vývěska umožní znovu spustit nebo ladit sadu testů. Pokud vyberete jeden nebo více testů v popisu, můžete také spustit nebo ladit pouze tyto testy. Tato akce umožňuje ladit testy, aniž byste museli opustit okno kódu.

Při ladění se kromě pozorování všech zarážek, které jste už možná nastavili, spuštění programu pozastaví, když ladicí program spustí metodu Assert , která vrátí neočekávaný výsledek.

Když najedete myší na neúspěšný test v tooltipu, rozbalí se, aby zobrazily další informace o selhání, jak je znázorněno na následujícím obrázku. Pokud chcete přejít přímo na neúspěšný test, poklikejte na něj v popisu.

Když otevřete neúspěšný test, Live Unit Testing vizuálně označuje v signatuře metody testy, které mají:

• Předané (označeno půlplným odměrným válcem společně se zeleným "✓").
• Neúspěšné (označeno poloplnou baňkou spolu s červeným "🞩").
• Nejsou zapojeni do Live Unit Testing (označuje to poloplná nádoba spolu s modrou "➖").

Netestní metody nejsou označeny symbolem. Následující obrázek znázorňuje všechny čtyři typy metod.

Diagnostika a oprava selhání testů

V neúspěšném testu můžete snadno ladit kód produktu, provádět úpravy a pokračovat v vývoji aplikace. Protože live Unit Testing běží na pozadí, nemusíte během ladění, úprav a pokračování cyklu zastavit a restartovat Live Unit Testing.

Například selhání testu zobrazené na předchozím obrázku bylo způsobeno nesprávným předpokladem v testovací metodě, že nealfabetické znaky se vrátí true při předání metodě System.Char.IsLower . Jakmile opravíte testovací metodu, měly by všechny testy proběhnout. Nemusíte pozastavit ani zastavit Live Unit Testing.

okno Live Unit Testing

Live Unit Testing, podobně jako Průzkumník testů, poskytuje rozhraní, které umožňuje spouštět a ladit testy a analyzovat výsledky testů. Pokud je funkce Live Unit Testing povolená, stav testů jednotek v Průzkumníku testů se okamžitě aktualizuje. Testy jednotek nemusíte explicitně spouštět.

Pokud živé testování jednotek není povolené nebo je zastavené, Live Unit Testing zobrazí stav testů jednotek při posledním spuštění testu. Po restartování Live Unit Testing se k opětovnému spuštění testů vyžaduje změna zdrojového kódu.

Live Unit Testing můžete spustit tak, že v nabídce nejvyšší úrovně Visual Studio vyberete Test>Live Unit Testing>Start. Okno Live Unit Testing můžete otevřít také pomocí Zobrazit>Další okna>Okno pro testování částí.

V okně Live Unit Testing si můžete všimnout, že některé testy jsou vybledlé. Když například zastavíte a restartujete Live Unit Testing, okno Live Unit Testing zmizí všechny testy, jak ukazuje následující obrázek.

Vybledlé výsledky testu naznačují, že test nebyl součástí nejnovějšího běhu Live Unit Test. Testy se spustí pouze v případech, kdy se zjistí změna testu nebo se zjistí závislosti testu. Pokud nedojde k žádné změně, vyhne se zbytečnému spuštění testu. V tomto případě je šedě zvýrazněný výsledek testu stále "aktuální", i když nebyl zahrnut v nejnovějším provedení.

Všechny testy, které se zobrazují jako vybledlé, můžete znovu spustit provedením změny kódu.

Existuje několik rozdílů mezi automatickým spouštěním a aktualizací výsledků testů prostřednictvím Live Unit Testing a explicitním spouštěním testů z Průzkumníka testů. Mezi tyto rozdíly patří:

• Spouštění nebo ladění testů z okna Průzkumníka testů spouští běžné binární soubory. Live Unit Testing spouští instrumentované binární soubory.
• Live Unit Testing nevytvoří novou doménu aplikace pro spouštění testů. Místo toho spouští testy z výchozí domény. Testy spuštěné z okna Průzkumníka testů vytvoří novou doménu aplikace.
• Live Unit Testing spouští testy v jednotlivých sestaveních testů postupně. V okně Průzkumníka testů můžete zvolit paralelní spouštění více testů.

Zrušení testovacích běhů Live Unit Testing

Live Unit Testing udržuje testy vždy, když provedete jakékoli změny kódu. Pokud probíhá spuštění a provádíte další změny kódu, Live Unit Testing zařadí další spuštění do fronty, zatímco čeká na dokončení prvního spuštění.

Kdykoli uložíte soubory, Live Unit Testing zruší první spuštění a okamžitě naplánuje spuštění ve frontě. Tento proces pomáhá se scénáři, kdy dokončení prvního spuštění trvalo dlouhou dobu.

Viz také

• Nástroje pro testování kódu
• Blog o Live Unit Testing
• Nejčastější dotazy k Live Unit Testing