Asial Blog

Monaca Cordova 4.1 Migration Guide

Category :
Monaca
Tags :
Monaca
Thank you for using Monaca!

On January 30 we will perform maintenance of the Monaca service. Please see the schedule below.



  • Maintenance will start Friday, January 30, 2015 22:00 (JST) and will take approximately one hour.

  • The Monaca Backend will still be usable during the maintenance.




After the maintenance the latest Cordova version, Cordova 4.1, will be supported. For those who have existing Cordova 3.5 or Cordova 2.9 projects we have prepared a migration guide. If you would like to update to Cordova 4.1 please see the migration guide

Release notes



Updating Cordova version for Monaca projects




  • In addition to Cordova 3.5, Cordova 4.1 can also be selected.

  • When creating new projects, Cordova 4.1 is selected by default.

  • Updating existing projects to Cordova 4.1 must be done manually. Please see the
    migration guide

  • It’s possible to freely change from Cordova 3.5 to 4.1 and vice versa.

  • Support for the new App Store policy that will be enforced on February 1, 2015.

  • Icons and splash screens for iPhone 6 and iPhone 6 Plus can be configured from Monaca IDE.

  • For existing projects, icons and splash screens for iPhone 6 and iPhone 6 Plus must be registered when building. Please see the migration guide for more details.

  • Projects based on Cordova 4.1 use the high performing WebView engine Crosswalk 10. Security updates has been applied so vulnerability warnings will not be displayed in Google Play.



Updates regarding Cordova plugins




  • Cordova plugins have been updated and a lot of changes are included. The version numbers for all plugins are available in the Monaca Documentation.

  • The problem where the geolocation plugin for iOS wasn’t working has been fixed.

  • When creating project from template the StatusBar plugin that was previously included by default has been deactivated. The StatusBar plugin can be reactivated in “Manage Cordova Plugin…”



Android Monaca Debugger 3.2.0 released




  • The Android Monaca Debugger has been updated to version 3.2.0. Please upgrade to the latest version.

  • The problem where the debugger was unable to download or update projects after a restart has been resolved.

  • The StatusBar plugin has been removed from the store version of the debugger.

  • To use the StatusBar plugin, use the custom debugger from the Monaca IDE or try with a built project.



iOS Monaca Debugger 3.2.0 released




  • Please update to the latest version of the debugger.

  • Support for splash screen in iPhone 6 and iPhone 6 Plus.

  • The StatusBar plugin has been removed from the store version of the debugger.

  • To use the StatusBar plugin, use the custom debugger from the Monaca IDE or try with a built project.



Support for iOS versions




  • iOS 7 and iOS 8 will be supported by Monaca.

  • Support for iOS 6 will be terminated.



Support for Cordova




  • Support for Cordova 2.9 will be terminated. For existing 2.9 projects is will still be possible to build but in the coming months the build service will be discontinued.



Cordova 4.1 Migration Guide



For people who update from Cordova 2.9 to 4.1 please refer to this document.

How to change Cordova version



Open the project in the Monaca Cloud IDE. Click “Settings -> Manage Cordova Plugin…” and the plugin management screen will be displayed. The Cordova version can be selected in the upper part of the screen.



Adding icons and splash screen for iPhone 6 and iPhone 6 Plus




Icons and splash screens for iPhone 6 and iPhone 6 Plus can be registered under “iOS App Settings…” in the Monaca Cloud IDE. This is necessary to submit apps to the App Store.




The StatusBar plugin has been removed from the Monaca Debugger




The StatusBar plugin has been removed from the Monaca Debugger. Because of this the appearance of apps running in the debugger may change. For existing projects we recommend the two following methods.

1. Without updating the app



When using the Custom Build version of the debugger it is possible to build a debugger that is similar to the earlier version. In this case the Status Bar plugin is included and the Cordova version is 3.5.1.
Please see this document for information about how to use the Custom Build version of the debugger.

2. Changing the app to match the new appearance



Open “Settings -> Managa Cordova Plugin…” and deactivate the Status Bar (org.apache.cordova.statusbar) plugin. When building the appearance will match the debugger.

In this case it will be necessary to change the program code.

- If the app is using Onsen UI you need to comment out the ons.disableAutoStatusbarFill() call.
- For apps that don’t use Onsen UI, the "margin-top" CSS rule can be used to free up a 20px area at the top of the page.