Skip to main content

Known Issues

CPU Cores​

  • When running MATRIX on Android, the device must be configured to use 4 cores. You can see how to configure this in CPU and RAM Settings.

Devices​

  • Devices need to be created after February 1st, 2024 to be eligible for MATRIX.
  • Devices must be Android 11 or newer.

Rooted / Jailbroken only​

MATRIX does not support non-rooted and non-jailbroken devices. To use MATRIX, ensure that the device is rooted (Android userdebug) or jailbroken (iOS) when creating the device.

Ensure the Application Remains Active​

When running MATRIX, ensure that the app is open in the virtual device until the report has generated. If the app is closed, there is a chance the report will not be generated.

Automatic Test Failures​

MATRIX test might automatically fail if...

  1. During monitoring, the user doesn’t open the target app in the virtual device.
  2. During monitoring, the user turns off the virtual device.
  3. Before report has generated (aka during testing), the user closes the target app in the virtual device.
  4. Before report has generated (aka during testing), the user turns off the device.

Using Regex in the Keywords File​

Specifying Regex in the keywords file requires the device to have grep version 3.11-1 installed. Virtual iPhones created after the 6.4 release shouldn’t need to upgrade, but it is still recommended you verify the grep version on your device to ensure regex support:

grep --version

If the above command returns anything less than 3.11-1 you will need to update the grep version:

First run:

apt-get update

Then update the grep version:

apt-get install grep=3.11-1

Verify the version:

grep --version