Spuštění testů DevFund prostřednictvím příkazového řádku

Přehled

Testy DevFund a SysFund můžete spustit několika způsoby prostřednictvím příkazového řádku. Pokyny na této stránce jsou určené ke spuštění testů prostřednictvím příkazového řádku se sadou Visual Studio a sadou Windows Driver Kit (WDK), ale bez zřízení testovacího systému prostřednictvím sady Visual Studio.

Mezi další metody spouštění testů DevFund a SysFund patří:

• Sada HLK (Hardware Lab Kit): Testy lze spustit z příkazového řádku na klientském testovacím počítači HLK.

• Testovací počítač zřízený prostřednictvím sady Visual Studio: Spuštění testu přes příkazový řádek

• Enterprise Windows Driver Kit (EWDK– nevyžaduje Visual Studio): Pokud není sada Visual Studio nainstalovaná a nebude použita, spusťte sadu EWDK ke spuštění testů na příkazovém řádku.

Nastavení

Všimněte si, že následující příkazy musí být spuštěny z příkazového řádku se zvýšenými oprávněními nebo správce, protože instalace WDTF nainstaluje ovladače do systému. Následující pokyny předpokládají, že systémová architektura je x64. Následující kroky je možná potřeba upravit pro jiné architektury.

Krok 1 : Instalace sady Visual Studio a sady Windows Driver Kit (WDK)

Krok 2 : Testy používají službu TAEF .

Pokud chcete nainstalovat službu TAEF (Te.service), přejděte do %PROGRAMFILES(X86)%\Windows Kits\10\Testing\Runtimes\TAEF\x64 a spusťte následující příkazy, abyste službu spustili:

1. wex.services.exe /install:te.service (Ověřte, že se te.service úspěšně nainstaloval.

2. sc start te.service (Ověřte, že stav je START_PENDING.

3. sc query te.service (Ověřte, že 'STAV' je 'SPUŠTĚNÝ')

4. sc qc te.service (Ověřte, že START_TYPE je AUTO_START.

Přidejte tento adresář do proměnné prostředí PATH systému a restartujte příkazový řádek se zvýšenými oprávněními.

Krok 3 : Nainstalujte WDTF tak, že přejdete do umístění MSI WDTF (%PROGRAMFILES(X86)%\Windows Kits\10\Testing\Runtimes\) a nainstalujete balíček pro požadovanou architekturu. Zadejte umístění a název souboru protokolu instalace %USERPROFILE%\Desktop\WDTFInstall.log v tomto příkladu:

cd %PROGRAMFILES(X86)%\Windows Kits\10\Testing\Runtimes\

msiexec /i "Windows Driver Testing Framework (WDTF) Runtime Libraries-x64\_en-us.msi" /l\* "%USERPROFILE%\Desktop\WDTFInstall.log"

WDTF MSI nainstaluje WDTF do %PROGRAMFILES%\Windows Kits\10\Testing\Runtimes\WDTF protože tento příklad používá 64bitový instalační balíček WDTF MSI, i když WDTF MSI bylo pod %PROGRAMFILES(X86)%

Krok 4 : Konfigurace počítače pro testování:

• Nakonfigurujte počítač tak, aby shromáždil úplné výpisy paměti nebo připojil ladicí program jádra.

• Vzhledem k tomu, že testy mohou potenciálně restartovat počítač a potřebují řídit cykly spánku, nakonfigurujte počítač tak, aby nikdy neusnul, nikdy nevypnul displej a automaticky se přihlásil do testovacího účtu (netplwiz.exe). Mějte na paměti, že autologon by měl být používán s opatrností.

Krok 5 : Spusťte test. Testy DevFund se nacházejí v %PROGRAMFILES(X86)%\Windows Kits\10\Testing\Tests\Additional Tests\x64\DevFund.

Základní příkaz pro spuštění testu DevFund je ve formuláři:

Te.exe Devfund_<testname>.dll /name:"<test case name>" /p:"DQ=DeviceID='<Device Instance Path of device under test from Device Manager>'" /RebootStateFile:state.xml

< název testovacího případu> je název testu v binárním souboru testu.

Přepínač / název je volitelný. Vzhledem k tomu, že některé binární soubory testů obsahují více testů, přepínač / název určuje, které testy se mají spustit. Pokud není zadáno, všechny testy obsažené v binárním souboru testu se spustí postupně. Seznam testů v binárním souboru testu lze získat spuštěním následujícího příkazu:

Te.exe Devfund\<testname>.dll /list

Například Devfund_PnPDTest.dll obsahuje většinu testů souvisejících s PnP:

Te.exe Devfund_PnPDTest_WLK_Functional.dll /list

Test Authoring and Execution Framework v10.21 for x64

    Devfund_PnPDTest_WLK_Functional.dll

        PNPDTest

            PNPDTest::PNPDisableAndEnableDevice

            PNPDTest::PNPRemoveAndRestartDevice

            PNPDTest::PNPCancelRemoveDevice

            PNPDTest::PNPCancelStopDevice

            PNPDTest::PNPTryStopAndRestartDevice

            PNPDTest::PNPTryStopDeviceRequestNewResourcesAndRestartDevice

            PNPDTest::PNPTryStopDeviceAndFailRestart

            PNPDTest::PNPSurpriseRemoveAndRestartDevice

            PNPDTest::PNPDIFRemoveAndRescanParentDevice

            PNPDTest::DisableEnhancedDeviceTestingSupport

Příkaz pro spuštění jednoho testu z tohoto testovacího binárního souboru může vypadat takto:

c:\temp\Te.exe Devfund_PnPDTest_WLK_Functional.dll /name:PNPDTest::PNPSurpriseRemoveAndRestartDevice* /p:"DQ=DeviceID='my\device\id'" /RebootStateFile:state.xml