Skip to main content

Known Issues

CPU Cores & RAM​

  • 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.

  • While it's not required to have 4GB of RAM to run MATRIX tests on Android, we recommend increasing the RAM from 2GB to 4GB to avoid issues where the stop monitor might fail or the app could crash due to insufficent memory.

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.

Automatic Test Failures​

MATRIX test might automatically fail if...

  1. The target application is not kept in the foreground for the entire duration of the MATRIX test.
  2. The device is not kept in an "On" state until the MATRIX report has been generated.

Please review our Usage in the UI guide for a better understanding of how to use MATRIX in order to avoid automatic test failures.

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

Google Play Store Applications​

When downloading certain applications from the Google Play Store, multiple APK files may be installed on the device for a single app. This is due to Dynamic Delivery, a process used by Google Play to optimize the delivery of the app's APKs based on your device's configuration. Currently, when multiple APK files exist for a single application, the MATRIX test will fail.

MATRIX Compatibility with Preexisting Devices​

As new MATRIX checks and artifacts are introduced in a version release, additional tooling may be required to run them successfully. Devices created prior to a new Corellium version will not automatically include the new tooling. In such cases, you will need to create a new device to obtain the necessary tooling.