Key Points

Before starting to migrate your projects into Monaca, there are some key points you need to pay attention to in order to have a seamless migration.

Build environment

Before getting started with the migration, you may want to know about the supported Cordova version and build environment in Monaca.

All newly created projects in Monaca will be using the latest supported Cordova version (currently, Cordova 7.1) by default.

Cordova Android platform iOS platform Windows platform (electron)
cordova-9.0.0 8.0.0 5.0.1 1.1.1

For more information on build environment for lower Cordova version, pleaser refer to Build Environment.

Installed Plugins

In Monaca, Cordova plugins are managed by package.json file. If your plugin information is defined in config.xml file, you will need to import them again into Monaca. Please refer to Import Cordova Plugins.

3rd-party Cordova Plugins

Store-version Monaca Debugger (found in Google play or AppStore) only includes Core Cordova plugins. If your project contains any third-party Cordova plugins besides the Core Cordova plugins, you will need to build custom debugger to test this kind of project. Custom debugger will only include the plugins used in the project. Please refer to:

JS/CSS Component

There is a GUI page for you to manage CSS/JavaScript libraries.

  • For Monaca CLI, you can open the GUI page by running monaca remote config from the project directory.
  • For Monaca Localkit, you can go there by clicking on Settings menu.

You can then add various CSS/JavaScript libraries. However, this is only working if you include the following 2 lines into your index.html file:

<!--Load selected JavaScript libraries-->
<script src="components/loader.js"></script>
<!--Load selected CSS libraries-->
<link rel="stylesheet" href="components/loader.css"> 

Please note that loader.js file is also loaded cordova.js file. Therefore, if you are going to include the above lines, you can remove this line:

<script src="cordova.js"></script>

Output Directory

Lastly, please stay alert to the following points since it is neccessary for working with Monaca Debugger and Monaca Build Server.

  • The output folder for building process must be www. You may need to change the build output to www.
  • Make sure that opening index.html over file:// works. For example, you may need to set <base href="./" in the index.html.

See Also: