Skip to main content

Known Issues

Devices​

  • Devices need to be created after February 1st, 2024 to be eligible for MATRIX.
  • Devices must be Android 11 or newer.
  • Devices must be powered on, the apps tab must display all available applications, and apps should be launchable through the device's user interface before you can run a MATRIX test.
  • 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.
  • 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.

CPU Cores & RAM​

  • We have identified that some MATRIX tests are failing due to RAM issues on Android devices created with 4 cores and 4 GB RAM. If your application is encountering failures during the Stop Monitoring phase of the MATRIX test, we recommend reconfiguring your Android device with 6 cores and 6GB of RAM, then running the test again. You can see how to configure this in CPU and RAM Settings.

Device Stroage is full (iOS Only)​

  • When you repeatedly run MATRIX tests on an iOS device, you may see available storage gradually dwindle over time. The culprit may not be files you can see at all, it's likely due to the hidden impact of an APFS snapshot. Here is a link on removing the APFS snapshots.

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.
  3. The target app cannot be launched or crashes on launch. This issue applies to Android system services listed as apps but without a UI to display, or apps that are not supported by Corellium in general.
  4. The target app has obfuscation, protection mechanics, or testing mitigation.

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 Keywords File​

note

When using the Frida memory-scan script, you must use exact matches, as this script does not attempt to use regular expression.

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