Known device issues

This section covers known issues for devices.

General

The following issues apply to Android devices in general.

When trying to connect to a wireless network on the device using the remote device access window, the password for the wireless network cannot be inputted using the device access window. This is due to a security mechanism which prevents the page from being displayed.
Workaround: Input the password on the physical device or use an API call to set the Wi-Fi connection.
Due to a customized home screen package on devices such as the Sony Xperia F8331 or the HTC U Ultra, objects on the home page may not be recognized.
On certain Android devices, for example OnePlus devices, we recommend that you turn off the battery saver/optimization feature. If this feature is enabled, the device may freeze during recording.
Foldable devices are supported but switching between screens is currently not supported. When a foldable device is opened remotely, the screen that is active is displayed and cannot be switched.

Huawei devices

The following considerations and workarounds apply when working with Huawei devices.

To ensure that a device remains connected when the USB mode is changed to Charge only, we recommend turning on Developer options > Allow ADB debugging in charge only mode.
Huawei Mobile services (HMS) are not supported.
Huawei devices use a security option that prevents the automatic installation of apps, and that may cause the device not to connect.
Workaround: In Developer Options, turn off the option Monitor apps installed by ADB.
Some Huawei devices have a Secure Keyboard setting that prevents remote device display.
Workaround: Turn off the Settings > System > Language & Input >Secure Keyboard option.
Black screen in the device access window when recording an object.
Workaround: Turn off the Settings > System > Language & Input >Secure Input option.

You can connect Harmony OS devices to OpenText Functional Testing Lab and test your Android (.apk apps) on them. The device is displayed in the lab console according to the Android version. Harmony OS apps are currently not supported.
Huawei Ascend P7-L10 4G: Activate USB debugging each time you reconnect the device to the lab.
Huawei Ascend T1/ Huawei P10 Plus, P20: The record and replay mechanisms are unable to identify certain objects in non-packaged apps.

Meizu devices

Some Meizu devices may require additional settings during app installation and packaging.

Meizu devices use a security option that prevents the automatic installation of apps.
Workaround: Open the Security system app, Navigate to Permissions> USB app installation and turn off the USB installation monitor.
Certain Meizu devices use a security option during installation that prevents the packaging of apps. This security option also prevents the recording and replaying of packaged apps.
Workaround: The security setting is per app. Turn off the security option for the app that you are testing.

OnePlus devices

OnePlus devices may require specific settings to improve recording and replay stability.

Slow record and replay on some OnePlus devices/ Can not identify object' errors or timeout error when trying to replay swipe steps on specific OnePlus devices.

Workaround:

After plugging in the device, go to Settings > Apps and search for io.appium.uiautomator2.server. In BatteryUsage switch on Allow background activity.
In Settings > Additional settings > Developer options switch on Disable permission monitoring.
Make sure that Verify bytecode of debuggable apps and Verify apps over USB are turned off.

Oppo devices - Chinese version

For Oppo devices (Chinese version), use the following setup steps to support reliable connectivity.

Before connecting an Oppo device, in Developer options, turn on Disable permission monitoring.
Note: On some devices, this setting is turned off automatically from time to time. Before running a test, check that the Disable permission monitoring setting is turned on.
Oppo devices use a security option that prevents the automatic installation of apps and that may cause the device not to connect. When connecting an Oppo device, turn off App Guard if it is displayed.

After connecting the device:

Go to Settings >Apps > App management > Functional Testing Lab for Mobile and Web Agent > App info > Battery usage.
Turn on the following settings:
- Allow background activity
- Allow auto launch
- Allow this app to launch other apps or services
Repeat the steps above for the following apps:
- io.appium.uiautomator2.server
- io.appium.uiautomator2.server.test
Go to Settings >Apps > App management > Functional Testing Lab for Mobile and Web Agent > Permissions > Display over other apps and set to Allow always.
Unplug the device and plug it into the connector machine again.

Occasionally when installing apps, the USB options popup is displayed. Make sure the option for File transfer is selected and close the popup on the physical device.

Oppo devices running on Android version 12: Occasionally, recording fails on hybrid unpackaged apps. This is due to the device's System Webview not detecting hybrid webviews. Workaround: Upgrade the device to a higher Android OS version, specifically Android 14 and WebView 117. This upgrade enables the device to detect hybrid webviews.

Vivo devices - Chinese version

Vivo devices (Chinese version) may require additional settings for app installation and background activity.

Vivo Security Care may prevent the automatic installation of apps and this may cause the device not to connect. Before connecting the device, turn off Security Care in Settings > Safe > More security settings > App installation > Security Care.

After connecting the device:

Go to Settings > Battery > Background power consumption management > Functional Testing Lab for Mobile and Web Agent.

Turn on High background power usage. This disables battery optimization.

Repeat the steps above for the following apps:
- Appium Settings
- U2 server
- u2 server test

Go to Settings > Apps & permissions > Permission management > Functional Testing Lab for Mobile and Web Agent. In > All permissions, turn on Background pop-ups.
Repeat this step for the following apps:
- Appium Settings
- U2 server
- u2 server test

Unplug the device and plug it into the connector machine again.

Occasionally when installing apps, the USB options popup is displayed. Make sure the option for File transfer is selected and close the popup on the physical device.

Xiaomi devices

The following known issues for Xiaomi devices also apply to Redmi and Poco devices.

You need to activate the Install app via USB in the Developer options settings. This requires you to have a registered Xiaomi account.
On devices with a MIUI version 8 or higher operating system, you must manually enable USB Debugging (Security settings) to allow proper integration with OpenText Functional Testing Lab.
Deactivate the Turn on MIUI optimization feature in the Developer options. MIUI optimization enables popup windows that may prevent apps from being installed.
Note: On Xiaomi devices with MIUI 12 or higher the Turn on MIUI optimization option is hidden by default. In Developer options, tap Reset to default values 4 times to display the option. You can now deactivate Turn on MIUI optimization.

Device emulator issues

The following limitations and workarounds apply when working with device emulators.

Changing device orientation is not supported for emulators.

The remote view for Android SDK emulators is supported only when you work without hardware acceleration. You can use acceleration when working in unattended mode.
You can deactivate hardware acceleration in one of the following ways:

Tool	Details
AVD window	Launch the AVD (Android Virtual Devices) tool, and deselect the Use Host GPU setting in the Emulation Options section.
Android Studio	Open the AVD manager. In the Verify Configuration page, select Software - xxxx as the Emulated Performance > Graphics option.

For details on configuring hardware acceleration for the Android emulator, see the Android Studio user guide.

For additional guidelines for working with emulators, see Troubleshooting and tips.