- Docs
- Administration
- Project settings
- Desktop Configuration
Desktop Configuration
Desktop Configuration lists the desktop applications a DESKTOP project tests and tells the runner how to start or attach to each one. The Desktop Recorder and every run read it.
In short
On this page you can
- Choose the platform: Windows (WinAppDriver) or macOS (Mac2Driver).
- Set the Appium server the agent uses next to the app.
- Add every application you test, with its AUMID, bundle ID or path and arguments.
- Attach to an already running window for WebView2 and PWA apps.
- Mark one application as the default for test cases that name none.
How to use it
- Open Configuration › Project Panel › Desktop Configuration.
- Under General Settings choose the Platform and check the Appium Server URL, then click Save Configuration.
- Under Applications click Add application, fill the dialog and click Save.
- Click the star of the app most tests use to make it the default.
- Open the Desktop Recorder: it starts with these values filled in.
The section appears for DESKTOP projects. “These settings are pre-filled in the Smartest Desktop Recorder and used by the runner.” Desktop projects test Windows and macOS apps. The agent must run on the machine with the app, a Windows PC or a Mac; see Install an agent and, for the Appium setup, Windows or Mac. Recording is covered in Discover › Desktop.
General Settings#
| Field | What it changes | Default |
|---|---|---|
| Platform | “Target desktop platform”: Windows (WinAppDriver) or macOS (Mac2Driver). It is also the platform new applications get. | Windows |
| Appium Server URL | The Appium server on the app’s machine. Must look like http://host:port; empty means the default. | http://localhost:4723 |
Click Save Configuration. Success: “Desktop configuration saved”. If the project has no application yet, you also see “No application yet: add one under Applications so tests can open the app”.
Retry count, wait timeout, continue on failure and screenshot on failure are not set here: desktop runs use Test Management and each pipeline’s own settings, like web and mobile.
Applications#
“Define every application you test. Each test case picks one (empty = default); a pipeline can override it.” Every change in this list saves immediately; it does not need Save Configuration.
Add an application
Click Add application and fill the dialog (fields below).
Save it
Click Save. Errors appear on the fields, with “Fix the highlighted fields.”
“Application added”. The first application of a project becomes the default.
Choose the default
Click the star of another app (“Make default”). The default shows a star and a Default chip.
| Field | What to enter | Rules |
|---|---|---|
| Name | “Shown in test cases and pipelines”, for example ERP Client. | Required, unique in the project (ignoring case). |
| Platform | Windows or macOS. | Defaults to the page’s Platform. |
| AUMID / App ID (Windows) or Bundle ID (macOS) | For Store / UWP apps on Windows, or the macOS bundle ID, for example com.example.MyApp. | Fill at least one: “Fill in AUMID / Bundle ID or App Path”. |
| App Path (.exe) or App Path (.app) | For classic Win32, WPF and WinForms apps, or the macOS app path, for example /Applications/MyApp.app. On macOS the runner reads the bundle ID from the app when you give only the path. | |
| App Arguments (optional) | Command-line arguments, for example --config prod. | — |
| Default Page Name | The page name the Desktop Recorder starts with for this app. | Default Desktop. |
| WebView2 / PWA app — attach to the running window | Only for Windows apps; the dialog hides it for macOS. The runner attaches to a window instead of starting the app. | Off |
| Window Title (attach) | “Text contained in the window title. Empty = the newly opened window.” | Shown when attach is on. |
Each row shows the app’s platform, its target (AUMID or path, or ⧉ window title when attached), and how many test cases use it.
Delete an application#
The dialog “Delete application?” tells you how many test cases use it: “{count} test case(s) use this application; they will switch to the default application.” If you delete the default, the oldest remaining application becomes the default.
Which application a test opens#
1. the application chosen in the pipeline (if the pipeline overrides it) 2. the application chosen in the test case 3. the project’s default application
Example: the project has ERP Client (default) and Label Printer. Test case “Print label” picks Label Printer; all other cases pick nothing. A pipeline without an override opens Label Printer for “Print label” and ERP Client for the rest. A pipeline that overrides with ERP Client opens ERP Client for every case.
Projects without applications#
Older desktop projects kept one application in single fields. While the list is empty, runs still use those values, and the list offers Save current as application to turn them into a list entry. Do it once, then manage everything in the list.
If something goes wrong#
Didn’t find your answer?Write to support with your project name and what you see on screen.
info@smartestqa.ai