Skip to content

Android Errors

jcesarmobile edited this page Feb 2, 2023 · 11 revisions

If running native-run commands you find any error, try running again the same command with --verbose flag. That should provide more information about what's going on.

This is the list of possible errors, if you get a different one, please, create a new issue on https://github.com/ionic-team/native-run/issues.

ERR_INCOMPATIBLE_UPDATE

This can occur if the app is already installed on the device and has a different signature than the APK you're trying to deploy. To fix this issue, completely uninstall the app from the device, then re-run native-run.

ERR_MIN_SDK_VERSION

This is the result of your APK's minimum SDK requirements being newer than the device supports. To fix this issue, lower the SDK requirements or use a newer device.

For Cordova, try setting the android-minSdkVersion preference in config.xml as listed in the Cordova config docs.

ERR_NO_CERTIFICATES

This is likely the result of improper signing. Make sure your keystore is generated and configured correctly when building APKs. It originates from the INSTALL_PARSE_FAILED_NO_CERTIFICATES ADB error.

For Cordova, make sure to use the correct signing flags or use a build.json file as shown in the Cordova Android Platform docs.

ERR_NOT_ENOUGH_SPACE

This means the target device doesn't have enough hard drive space to fit the app being deployed. To fix this issue, free up hard drive space on your device by clearing caches and uninstalling other apps.

ERR_SDK_NOT_FOUND

This means the Android SDK is not installed or can't be found. Make sure you have the Android SDK installed and a ANDROID_SDK_ROOT environment variable configured that points to the sdk folder inside your Android folder.

ERR_SDK_PACKAGE_NOT_FOUND

This means the Android SDK platform tools are not installed. Open Android Studio's SDK Manager and in SDK Tools tab search Android SDK Platform-Tools and install it

ERR_UNSUITABLE_API_INSTALLATION

A suitable Android SDK API installation was not found. Use --sdk-info to reveal missing packages and other issues. Make sure you have downloaded the Android SDK and an emulator system image.

ERR_UNSUPPORTED_API_LEVEL

You are using an Android SDK that is not supported by native-run. Please, let us know by creating a new issue https://github.com/ionic-team/native-run/issues.

As workaround you can downgrade your installed Android SDK. Latest supported version is SDK 33.

ERR_VERSION_DOWNGRADE

This can occur if the app is already installed on the device and has a newer version than the APK you're trying to deploy. To fix this issue, either increase the version of your app so that it is higher than the already installed version or completely uninstall the app from the device, then re-run native-run.