-
Notifications
You must be signed in to change notification settings - Fork 54
developer
The library is a programmers tool, and they will either need to have the source code of the application under test, or be able to 'explore'`the application to get the names of controls, etc.
The MS UIAutomation Library is a COM control, and the classes that represent this have been wrapped using native JNA calls (currently using 4.3.0).
The library is held in the Sonatype OSS repository, so is available for download via Maven (or other tools, such as SBT for Scala).
As the library depends on jna version 4.3.0, then don't specify the JNA library version in YOUR dependencies, the library will guide the dependencies and bring down the correct version.
<dependencies>
<!-- Other dependencies -->
<groupId>com.github.mmarquee</groupId>
<artifactId>ui-automation</artifactId>
<version>0.3.10</version>
<dependencies>
The ui-automation library is a wrapper for the UIAutomationClient library, which has been extracted using com4j. As the generated code is large and complex, this has been wrapped up in a number of classes, each providing classes that encapsulate part of this library (together with other utility methods as necessary).
In order to get access to the automation API, an UIAutomation instance needs to be created, this is done as follows.
UIAutomation automation = UIAutomation.getInstance();The AutomationApplication class provides functionality to start and attach to an application. There are 3 class methods provided to do this.
- Launch - this will launch the application supplied, and pass in any supplied arguments
- Attach - this will attach to an already launched application, based on the executable name
- LaunchOrAttach - this will either attach to an already launched application, or launch the application.
The snippet below will check whether Project1.exe is running, attaching to it if it is, or launch it if not.
AutomationApplication application = automation.launchOrAttach("...\\Project1.exe");To get a 'desktop' window (i.e. one that appears in the Windows tasks bar), then the AutomationDesktop class provides a class function that returns a AutomationWindow object.
AutomationWindow window = automation.getDesktopWindow("Form1");
window.focus();This will find (if it is there) a window that has the given title, and set focus to it. This window is independent of the overall application, and might not even be associated with the same application that is being automated.
Each control contained in a container (such as a window or panel) can be identified by the index of that control, sometimes (this depends on the control type), by the text associated with it, OR by the Automation Id. For example, in order to get the textbox associated with the connection window (and assuming that it is the 1st Edit box on the window), the following code will find the editbox, and change the text to be USER1.
AutomationEditBox user = window.getEditBox(0);
user.setText("USER1");In order to click the 'OK' button associated with a given window, it can be found by the text associated with the button, the following examples will all find the same button, and call the click event for it.
// Get button by index
AutomationButton button1 = window.getButton(0);
button1.click(); // Get button by name
AutomationButton button1 = window.getButton("OK");
button1.click(); // Get button by automation id
AutomationButton button1 = window.getButtonByAutomationId("btnOK");
button1.click();The controls that have been implemented reflect the requirements for automating the applications that we are testing ourselves, so some controls have not been implemented, or only partially. The currently supported controls are ...