6.0+37.4
Android

The following options influence the testing of Android applications.

Options for Android
Figure 37.27:  Options for Android
'Android SDK' (System)
Server script name: OPT_ANDROID_SDK_PATH

Enter the installation path of the Android SDK here. This directory is usually named sdk and contains a subdirectory tools or cmdline-tools.

This setting is only neccessary if QF-Test can not determine the path automatically.

'Log extra android information to run-log' (System)
Server script name: OPT_ANDROID_DEBUG

If this option is activated further information is logged in the log.

'Forward emulator output to QF-Test terminal' (System)
Server script name: OPT_ANDROID_FORWARD_EMULATOR_OUTPUT

If this option is activated and an emulator was launched via the 'Launch Android emulator' node, then the stdout/stderr output of the launched emulator will be passed on to the QF-Test terminal.

6.0+37.4.1
Recording Window

The following options can be used to customize the look and functionality of the Android recording window.

Options for the Android recording window
Figure 37.28:  Options for the Android recording window
Control without recording (System)
Server script name: OPT_RECORDING_CONTROL_STATE

If this option is set, clicks and other inputs in the Android recording window are passed on to the active device or emulator, even if the recording mode is not active.

Automatic scaling (System)
Server script name: OPT_RECORDING_DISPLAY_AUTO_SCALING

If this option is set, the preview image in the Android recording window will be automatically scaled according to the window size.

Show screen borders (System)
Server script name: OPT_SHOW_BORDER

Draws a Border around the edge of the virtual screen inside the Android recording window to make the edge clearly visible.

Show vertical toolbar (System)
Server script name: OPT_VERTICAL_TOOLBAR_STATE

Inserts an additional toolbar at the edge of the Android recording window containing actions for controlling possible hardware buttons of the device. In recording mode, these are also recorded as events.

Swipe on the top level component (System)
Server script name: OPT_SWIPE_ON_TOPLEVEL_COMPONENT

When the option is activated swipes will always be recorded on the top level component.

Due to differing screen sizes and resolutions of devices some components may not be located in the visible area. Then, swipes where the lower level component is not relevant may become unreliable. Especially for navigation swipes, the option can improve the recording.

Highlighting after click (System)
Server script name: OPT_CLICK_HIGHLIGHT

When the option is set clicks to recording window will highlight the respective component, showing a colored border around it for a short time. This can be useful to check whether a click was interpreted correctly.

Highlight duration (ms) (System)
Server script name: OPT_HIGHLIGHT_DURATION

With this you control how long a border around a selected component should be displayed.

Automatic refresh interval (ms) (System)
Server script name: OPT_RECORDING_AUTO_REFRESH_INTERVALL

This controls how often QF-Test will try to refresh the contents of the Android recording window.

Please be aware that the maximum refresh speed depends on the device or emulator used. A interval value lower than the maximum refresh speed will not have any effect.

Too low values may negatively impact system performance.

Number of refreshes after one click (System)
Server script name: OPT_REFRESH_STEPS

The option defines the number of times the recording window will be updated after a click. The option is only relevant when automatic updating has been disabled.

Depending on the configurable animation speed of Android it can happen that the preview window may be updated whilst an animation is executed. In that case the option can be useful.

Waiting time between refreshes after a click (ms) (System)
Server script name: OPT_INTERVAL_TIME_AFTER_CLICK

The option defines the time between two refreshes. The option is only relevant when automatic refreshing has been disabled.

Please be aware the maximum refresh speed depends on the device or emulator used. A interval value lower than the maximum refresh speed will not have any effect.