WPF - UI Automation & Appium Testing Support (v20.2)

Prepare an Environment

1. Enable Windows Developer Mode.
2. Install WinAppDriver.
3. Download the WinAppDriver UI Recorder.

Create a Test

1. Open the Windows command prompt, create a project folder or navigate to an existing folder, and use the following commands:
• dotnet new nunit --framework netcoreapp3.1 - Creates an empty nunit test project.
• dotnet add package Appium.WebDriver - References the Appium.WebDriver package in your project.
2. Open the nunit test project in the Visual Studio.
3. Create a DesktopSession class. The class allows you to use the code that the WinAppDriver UI Recorder will generate.
You can see our implementation below:

public class DesktopSession {
    const string WindowsApplicationDriverUrl = "http://127.0.0.1:4723/";
  	WindowsDriver < WindowsElement > desktopSession;
  	public DesktopSession(WindowsDriver < WindowsElement > source) {
    	desktopSession = source;
  	}
  	public WindowsDriver < WindowsElement > DesktopSessionElement {
    	get {
      	return desktopSession;
    	}
  	}
  	public WindowsElement FindElementByAbsoluteXPath(string xPath, int nTryCount = 10) {
	    WindowsElement uiTarget = null;
    	var index = xPath.IndexOf(value: '/', startIndex: 1);
    	xPath = xPath.Substring(startIndex: index);
    	while (nTryCount-->0) {
      		try {
        		uiTarget = desktopSession.FindElementByXPath(xpath: $ "/{xPath}");
      		}
      		catch {
        		Console.WriteLine($@"Find failed: ""{xPath}""");
      		}
      		if (uiTarget != null) break;
      		Thread.Sleep(millisecondsTimeout: 100);
    	}
    	return uiTarget;
  	}
  	public IOptions Manage() {
    	return this.desktopSession.Manage();
  	}
  	public void CloseApp() {
    	this.desktopSession.CloseApp();
  	}
}

4. Copy and paste the following test fixture to the UnitTest1.cs file:

public class Tests {
	Process pWad;
  	const string PathToTheDemo = @"C:\Users\Public\Documents\DevExpress Demos 20.2\Components\WPF\DevExpress.OutlookInspiredApp.Wpf\bin\DevExpress.OutlookInspiredApp.Wpf.exe";
  	protected DesktopSession desktopSession {
    	get;
    	private set;
  	} 
  
  	[OneTimeSetUp]
  	public void FixtureSetup() {
    	StartWAD();
    	var options = new AppiumOptions();
    	options.AddAdditionalCapability(capabilityName: "app", capabilityValue: PathToTheDemo);
    	options.AddAdditionalCapability(capabilityName: "deviceName", capabilityValue: "WindowsPC");
    	options.AddAdditionalCapability(capabilityName: "platformName", capabilityValue: "Windows");
    	var driver = new WindowsDriver < WindowsElement > (new Uri("http://127.0.0.1:4723"), options);
    	desktopSession = new DesktopSession(driver);
    	WaitSplashScreen(driver);
  	}
  	static void WaitSplashScreen(WindowsDriver < WindowsElement > driver) {
	    var cwh = driver.CurrentWindowHandle;
	    while (driver.WindowHandles.Contains(cwh))
	    Thread.Sleep(1000);
	    driver.SwitchTo().Window(driver.WindowHandles[0]);
  	}
  	private void StartWAD() {
	    var psi = new ProcessStartInfo(@"C:\Program Files (x86)\Windows Application Driver\WinAppDriver.exe");
	    psi.EnvironmentVariables.Add("DX.UITESTINGENABLED", "1");
	    pWad = Process.Start(psi);
  	} 
	  
  	[OneTimeTearDown]
  	public void FixtureTearDown() {
	    desktopSession.CloseApp();
	    pWad.Kill();
  	} 
	  
  	[SetUp]
  	public void Setup() {} 
  	
  	[Test]
  	public void Test1() {
    	Assert.Pass();
  	}
}

• Invokes the StartWAD method. The method launches the WinAppDriver.exe and enables UI testing mode.
• Creates a new Appium testing session.
• Invokes the WaitSplashScreen method and suspends the test during app load operations.

UI Testing Mode

[Test][Order(0)]
public void CreateEmployee() {
	var desktopElement = desktopSession.DesktopSessionElement;
	var bNewEmployee = desktopElement.FindElementByName("New Employee");
  	bNewEmployee.Click();
  	WindowsElement newEmployeeWindow = null;
  	while (newEmployeeWindow == null)
  	newEmployeeWindow = desktopElement.FindElementByName("Employee (New)");
  	newEmployeeWindow.FindElementByName("First Name").FindElementByClassName("TextEdit").SendKeys("John");
  	newEmployeeWindow.FindElementByName("Last Name").FindElementByClassName("TextEdit").SendKeys("Doe");
  	newEmployeeWindow.FindElementByName("Title").FindElementByClassName("TextEdit").SendKeys("CTO");
  	newEmployeeWindow.FindElementByName("Mobile Phone").FindElementByClassName("ButtonEdit").SendKeys("1111111111");
  	newEmployeeWindow.FindElementByName("Email").FindElementByClassName("ButtonEdit").SendKeys("john.doe@dx-email.com");
  	newEmployeeWindow.FindElementByName("Save & Close").Click();
}

Free DevExpress Products - Get Your Copy Today