README.md

Test Device Runners

A set of device runners for various testing frameworks.

The current platforms are:

• Android
• iOS
• macOS (using Mac Catalyst)
• Windows (using WinUI 3)

The current testing frameworks supported are:

• Xunit
  • Visual device runner
  • XHarness (CI) device runner
• NUnit
  • Visual device runner

Testing with the Visual Runner

Testing using the visual runner is just a matter of running the test app like any other app. This can be done via the CLI or in the IDE.

More information can be found in the wiki: Visual Runner in the IDE

Testing with the CLI

Test can also be run on the CLI - both locally and on CI. For tests on Android, iOS and Mac Catalyst, there is the XHarness tool. For Windows, all we need is PowerShell.

More information can be found in the wiki:

• Using XHarness
• iOS - XHarness
• Android - XHarness
• Mac Catalyst - XHarness
• Windows - PowerShell

UI Testing Support

More information can be found in the wiki: UI Tests

Credits

This is repository contains revised code from a few places:

• https://github.com/xunit/devices.xunit
  This code was migrated to use .NET MAUI and then split into components so that the UI can be separate from the test runner.
• https://github.com/xunit/uitest.xunit
  This code was migrated to use .NET MAUI.
• https://github.com/nunit/nunit.xamarin
  This code was migrated to use .NET MAUI and then features were added to support running individual tests.
• https://github.com/dotnet/maui
  This was the home for a short while during the migration.