TcUnit.TestAdapter 0.0.5-beta

TcUnit-VsTestAdapter

TcUnit-VsTestAdapter makes it possible to execute TcUnit (TwinCAT unit tests) with the Microsoft Visual Studio Test Plattform

For more details see vstest test adapter extensibility

Table of Contents

• Usage
  • vstest.console.exe
  • Azure Pipelines
• Best Practice
• RunSettings

Usage

This section describes how to execute TcUnit tests in Azure DevOps pipelines or locally with Microsoft.TestPlatform.

vstest.console.exe

It is also possible to run TcUnit tests on a VM that has vstest.console.exe installed.

Setup Microsoft.TestPlatform on a VM

Let's assume that the working folder is C:\Tools.

1. Download and install NuGet.

2. Install NuGet package Microsoft.TestPlatform

   nuget install Microsoft.TestPlatform
   

Find vstest.console.exe in C:\Tools\Microsoft.TestPlatform.16.7.1\tools\net451\Common7\IDE\Extensions\TestPlatform. Add this folder to the PATH environment variable.

3. Install TcUnit.TestAdapter

   nuget install TcUnit.TestAdapter
   

4. You may now create a *.cmd / *.ps1 file, put it inside your TcUnit tests project and run it after compile

   vstest.console.exe /TestAdapterPath:C:\Tools\TcUnit.TestAdapter.1.0.0\lib\netstandard2.0 /Settings:TcUnit.runsettings *\*.tsproj
   

   See TwinCAT PLC Deployment for more information

Azure Pipelines

• Setup
• Execution

1. Add NuGet tool installer task to install NuGet.exe.

   Example:

   steps:
   - task: NuGetToolInstaller@0
     displayName: 'Use NuGet'
     inputs:
       versionSpec: 4.4.1
   

2. Add NuGet task. Set command to custom and specify the command line:

   install TcUnit.TestAdapter -Version $(TcUnitTestAdapterVersion)
   

   Example

   steps:
   - task: NuGetCommand@2
     displayName: 'NuGet Install TcUnit.TestAdapter'
     inputs:
       command: custom
       arguments: 'install TcUnit.TestAdapter -Version $(TcUnitTestAdapterVersion)'    
   

   In the pipeline settings set TcUnitTestAdapterVersion variable to the TcUnit.TestAdapter version you want to install (e.g. 1.0.0). The task will install TcUnit.TestAdapter into

   $(Build.Repository.LocalPath)\TcUnit.TestAdapter.$(TcUnitTestAdapterVersion)\lib\netstandard2.0
   

3. If you plan to run tests on a self-hosted Windows Agent that does not have Visual Studio installed you need to add Visual Studio Test Platform Installer task.

   Example:

   steps:
   - task: VisualStudioTestPlatformInstaller@1
     displayName: 'Visual Studio Test Platform Installer'
     inputs:
       versionSelector: latestStable
   

4. To run tests you need Visual Studio Test task.

   Example:

   steps:
   - task: VSTest@2
     displayName: 'VsTest - Run TcUnit Tests'
     inputs:
       testAssemblyVer2: |
        $(Build.Repository.LocalPath)\Tests\*.plcproj
       runSettingsFile: '$(System.DefaultWorkingDirectory)\.ci\TcUnit.runsettings'
       pathtoCustomTestAdapters: '$(Build.Repository.LocalPath)\TcUnit.TestAdapter.$(TcUnitTestAdapterVersion)\lib\netstandard2.0'
       platform: '$(BuildPlatform)'
       configuration: '$(BuildConfiguration)'
   

   Make sure that path to custom test set adapters is set to

   $(Build.Repository.LocalPath)\TcUnit.TestAdapter.$(TcUnitTestAdapterVersion)\lib\netstandard2.0
   

   Specify patterns to search for *.plcproj files in the test files section (testAssemblyVer2 in YAML).

   If you added Visual Studio Test Platform Installer task on the previous step do not forget to set vsTestVersion in YAML (or Test platform version in Classic UI):

   vsTestVersion: toolsInstaller
   

5. To publish test results (for later review and downloading) use Publish Build Artifacts task. Execution results are copied to $(Agent.TempDirectory)\TestResults.

   Example:

   steps:
   - task: PublishBuildArtifacts@1
     displayName: 'Publish Artifact: TestResults'
     inputs:
       PathtoPublish: '$(Agent.TempDirectory)\TestResults'
       ArtifactName: TestResults
   

Best Practice

Filter

TcUnit.TestAdapter supports filter

RunSettings

Use custom run settings

vstest.console.exe /Settings:path\to\TcUnit.runsettings

.runsettings file is used to pass parameters to the test run.

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
    <TcUnit>
        <Target>127.0.0.1.1.1</Target> 
        <Port>851</Port>
    </TcUnit>
</RunSettings>