Skip to main content

How to Merge a Split APK

note

You will need the following tools:

If you are provided with split APK files, you will need to merge and re-sign them yourself before installing to Corellium:

  1. Download and extract the downloaded zip archive (assuming the APK files were provided in a zip).
  2. Run the APKEditor to merge the APKs by referencing the path to the APK directory (in our example they're in apks/): 
    java -jar /path/to/APKEditor-1.4.2.jar m -i /path/to/<mysplitAPKdirectory>/
    note

    Your APKEditor and APK Signer versions may be different.

  3. Check for a new output file named <mysplitAPKdirectory>_merged.apk.
  4. Run uber-apk-signer to re-sign the APK using: 
    java -jar /path/to/uber-apk-signer-1.3.0.jar --apks <mysplitAPK>>_merged.apk
  5. Check for a new output file named <mysplitAPK>_merged-aligned-debugSigned.apk.
  6. Install the signed APK on a Corellium Android device.

If your app was installed via Google Play Store (and Gapps) but is having trouble in MATRIX, it's likely a split APK. You can retrieve the files via the steps below:

  1. Under the files tab, navigate to /data/app/
  2. Find your app and download its files.
    note

    You won't be able to download the empty lib/arm64 folders.

  3. Unzip your download.
  4. Recreate the lib/arm64 filepath in your newly extracted folder.
  5. Follow the steps above to recreate the app install file.
  6. Uninstall the original app and reinstall your new merged, signed .apk file.