Test agent setup on Windows ARM

Android Espresso Agent

Setup Hydra Lab Agent on Windows(X86/X64)

1. Register an agent in Hydra Lab Center WebSite. (Please contact hydra_lab_support@microsoft.com if you are Microsoft FTE and want to use the MS internal network)

2. Create a new folder in you PC.
3. Download the latest agent.jar or build the agent project as agent.jar. Then, copy the file to the folder. To build the agent, run the following command in the project root dir:

gradlew :agent:bootJar

4. Unzip HydraLab_Agent_Installer_Windows.zip to the folder, the folder shows like this picture.

5. Download application.yml from portal (a sample configuration is available here: sample YAML config)

• app.registry.server
  • The hostname + port of the center server. For instance, if it's running on a machine with the hostname of testagent.hydralab.com and servicing on port 9886, then this value should be "testagent.hydralab.com:9886".
• app.registry.id
• app.registry.secret
• app.registry.name
• app.registry.agent-type (An int value to indicate the type of test devices for Testing)
  • Value 1 represents WINDOWS PC + n * ANDROID devices -> For Android test agent.
  • Value 2 represents WINDOWS PC + 1 * ANDROID device, support running Appium Test case on Windows -> For Windows-Android cross-platform agent.
  • Value 3 represents WINDOWS/MAC PC + n * iOS devices -> For iOS test agent.
• management.metrics.export.prometheus.pushgateway.enabled (Optional; If true, will send metrics to our stability monitor. When an exception happens, we will receive emails.)

Start/Stop Hydra Lab Agent

1. Android or iOS agent

1. Setup log file location: modify AgentService.xml and replace {LOG_FILE_LOCATION}

2. Install it as a Windows Service: open cmd/powershell (admin), execute command : .\AgentService.exe install

3. Open Windows Services and find a service named Hydra Lab Agent Service.

4. You can start/stop the service.

5. If it starts successfully, the agent will show up in HydraLab center portal. BTW, only the agent connected with devices will be displayed on the page.

2. Cross-platform agent (Windows + Android)

PS. The WinAppDriver can't work normally if started by Windows Service.Issue link

1. Update restartAgent.bat: comment line18,31 and uncomment line 20,29.

2. Start agent directly: open cmd/powershell (admin); cd to the install folder; execute restartAgent.bat script

If you want to keep your Windows test agent awake without locking itself over time, so as to run UI tests for Windows apps, consider leveraging the PowerToy toolset - awake feature | Awake Utility to keep the Windows device active.