Common Build and Application Upload Errors
Here is a list of common errors you may face when building or uploading an application to App Store Connect:
minSdkVersion
Sometimes you may use a Cordova plugin which requires a different API level configuration from your project's default settings. For example, in this case, your default setting for minimum API level is 14 (minSdkVersion=14
). However, one of your plugins requires an API level of at least 16. In other words, the minSdkVersion
value is lower than the one required by the plugin.
In order to solve this error, you can just correct the value of minSdkVersion
in the config.xml
file as follows:
Provisioning profile
When you are using MonacaBackend
or NIFCloudMB
plugins for Cordova 6.5 or later in your project, this error will occur if your current provisioning profile doesn't have the right configuration for push notification in iOS.
To fix this error, use the right configuration for push notification as follows:
use an app ID for push notification
get a push notification certificate
get a push notification provisioning profile
The app ID set for the target project does not match the bundle ID. Please make sure that your app ID setting matches the one in your provisioning profile.
This might be caused by a mismatch/inconsistency in the iOS Build configuration. Please make sure to use the correct app ID with a corresponding certificate and provisioning profile.
This might be caused by a mismatch/inconsistency in the iOS build configuration. For example: the app ID in the provisioning profile not matching with the bundle identifier. Make sure to use the correct app ID with a corresponding certificate and provisioning profile.
Application name
A number is set at the beginning of the application name. Check the application name on the app settings screen.
Splash screen
This is an error related to the splash screen image files:
You might be using a different file format rather than PNG. Currently, only
PNG files are supported as splash screen images in Monaca.
Splash image files might be corrupted.
If you are using 9-patch format images, please make sure the format
is correct.
OutOfMemory
If your Android build fails with the following error, the memory usage may have exceeded the limit. Please use this plugin to change the Android build memory size.
Project files
This might be caused by an invalid file name in the project files. Please make sure that any double-byte characters or special characters are not used in the file names of the project.
Android KeyStore
Failed to read the key name of a KeyStore file. Please make sure to:
use the correct KeyStore in the Android build settings.
enter the right password for the corresponded KeyStore before starting
the build.
Crosswalk plugin
This might occur when the Crosswalk WebView Engine
plugin v2.2.0 or higher is enabled in a Cordova 6.2 project. If you are using the Crosswalk WebView Engine
plugin in a Cordova 6.2 project, please use v2.1.0
or lower.
For Cordova 6.2 projects, the following configurations for theCrosswalk WebView Engine
plugin are confirmed to build successfully:
Plug-in version:
1.7.2
with Crosswalk version:18.48.477.13
(defaultconfiguration)
Plug-in version:
2.1.0
with Crosswalk version:21.51.546.7
App Store Connect
The Apple ID
or Password
used when uploading the app to App Store Connect has not been entered correctly. Please make sure to use the right Apple ID
and corresponded Password
.
If the Apple ID
used when uploading the app to App Store Connect is using 2-factor authentication, please try using the app-specific password. For more information, please refer to App-specific Password.
Please make sure 'com.example.xxx
' is registered in App Store Connect.
There is an application with the same build version in App Store Connect. Please build the app again with a different version number.
The version number in the current app build is lower than the last certified app build. Please build the app again with a higher version number.
When updating an application, it is not possible to reduce the number of supporting devices. Please check the settings of the target device in the iOS application settings.
There is a possibility that the App Store icon is transparent or contains an alpha channel. Please check the App Store icon.
The target project is not built with Xcode 9 or later. If the target project is using a lower version than Cordova 7.1, you need to upgrade to Cordova 7.1. From March 2019, you need to build with Xcode 10.1. To set the target project to Xcode 10.1, see Build Environment Settings.
Last updated