Application

Can I use an external ad network?

For Monaca, there is no particular restriction on installing an ad network in an application. Technically, ads can be posted on WebView, so please use them according to the agreements of each ad network company.

Can I use external backend service?

You can use external backend services with Monaca. We also provide some external services (including backend) you can integrate into your project right from Monaca Cloud IDE.

From Monaca Cloud IDE, go to Configure → Service Integration Settings → Backend to see exisiting external backend services.

If you cannot find the backend service you want there, you can import its SDK into Monaca by going to Configure → Cordova Plugin Settings → Import Cordova Plugin.

What kind of features can be used in applications developed using Monaca?

With Monaca you can develop applications that are able to use all types of unique features on smartphones.(Camera, GPS, etc.) Please refer to the documents below.

Windows Store apps are not compatible with Cordova Core Plugins, but compatible with developments that used WinJS.

In applications that are developed using Monaca, can I embed codes written in Java? (For Android)

Monaca currently does not support embedding of Java native codes.

Can I use UIKit with an application developed with Monaca?

Monaca currently does not support using UIKit.

Can I develop applications with many different screen sizes?

In order to develop an application with many different screen sizes, you can include the following meta tag in your code.

<meta name="viewport" content="width=device-width, height=device-height, initial-scale=1, maximum-scale=1, user-scalable=no">

Can I use Cordova plugins?

For Basic and Personal plans, you can use the built-in Cordova plugins such as ChildBrowser, DatePicker, Bluetooth and so on. Please refer to Third-party Cordova Plugins for all the built-in Cordova plugins provided by Monaca. However, In order to add Custom Cordova plugin, you will need to have a Gold or Platinum plan. To add a custom Cordova plugin, please refer to Custom Cordova Plugins.

What are the restrictions for developing Windows Store apps?

For Windows Store app development, native JavaScript and HTML5 features are used. Therefore, features such as those in PhoneGap cannot be used. For this reason, in order to develop an app that runs on both Windows (Windows store app) and other platforms, you can't use features such as those in PhoneGap. Also, for Windows Store app, there are some features and properties in the standard JavaScript and HTML5 that can't be used. For more details, please refer to HTML, CSS, and JavaScript features and difference.

Can I develop a full-screen app?

Yes, you can. However, you need to make configuration differently on iOS and Android.

Android

There are two ways to make an app runs in fullscreen mode:

  1. By Android App Configuration panel: From Monaca Cloud IDE, go to Configure → App Settings for Android. Then, enable the fullscreen mode.

  2. By config.xml file: input the following line in the file:

<preference name="Fullscreen" value="true"/>

iOS

You need to use StatusBar Plugin to hide the native status bar.

To ensure the configuration is updated successfully, please build your app again after making the above configuration.

Can I always use the latest version of Cordova?

Monaca supports specific Cordova versions. However, we regularly update and provide the latest Cordova version support as soon as possible.

How can I make font size bigger for input and textarea controls?

You can fix this problem by applying following styles.

form input, form textarea {
    font-size: 100%;
}

Cordova API and Monaca JavaScript API do not work.

Please check if components/loader.js file is loaded in your code. You can't use Cordova API and other JavaScript APIs provided by Monaca if the file is not loaded.

How to change the app start page from index.html to another?

  1. Go to config.xml file under www folder.

  2. Under <widget> element, input the location of the file you want to set as the starting page in the <content> tag. The default value is index.html. See the example below:

<?xml version="1.0" encoding="UTF-8"?>
<widget xmlns="http://www.w3.org/ns/widgets" id="com.example.helloworld" version="1.0.0">
    ...
    <content src="https://monaca.io/" />
</widget>

This method won’t work in Android Debugger downloaded from Google Play. Creating a custom Android debugger will solve this issue. Please refer to Build and Install Custom Monaca Debugger.

Limitation of version number and version code for Monaca apps

Based on Cordova, the maximum value of version number is 99.99.99 and the corresponding maximum value of version code is 999999 for Monaca apps.

If you want to use a larger version code value, you need to modify config.xml file directly. See below example:

<widget xmlns="http://www.w3.org/ns/widgets" id="your packagename" version="xx.yy.zz">
<!--Substitute xx.yy.zz to 100.1.3, the version code becomes 1000103.-->

Starting from 2014/04/02, config.xml file is located under the www folder. If your project is created before that, config.xml file is located in android/config.xml and ios/config.xml for Android and iOS respectively.

Cordova APIs (such as camera, compass, and so on) are not working.

When using Cordova APIs (such as camera, compass, and so on), you need to make sure that those APIs are called after they are loaded and are ready to access.

The deviceready event fires once the Cordova is fully loaded. You can safely use Cordova APIs when this event is fired. For more information, please refer to deviceready event.

For Onsen UI, ons.ready() function is called when both deviceready and DOMContentLoaded events are fired. Therefore, you can deal with both events by using ons.ready() function.

The built app does not work or works differently than on the debugger.

It is likely that the built app does not contain the necessary Cordova plugin. Although Monaca Debugger contains all core plugins by default, you need to manually specify which plugin to install when you build the app. You can manage the plugins to be included in the app by enabling them in Manage Cordova Plugins configuration.

Can the iOS' App ID and Android's package name be different?

Currently, when you update either iOS' App ID or Android's package name, both of them will change. In other words, they are configured to be the same. However, it is possible to make them different.

In order to set iOS's App ID and Android's package name different, update the <widget> tag in config.xml file by adding the values for android-packageName and ios-CFBundleIdentifier while removing the existing id value. Here is an example of the updated file:

<widget xmlns="http://www.w3.org/ns/widgets" android-packageName="com.example.android" ios-CFBundleIdentifier="com.example.ios" version="1.0.0”>

With this kind of configuration, all builds are succeeded except Android’s custom Debugger build.

How to get SHA-1 fingerprint of a keystore created in Monaca Cloud IDE?

Assuming that you already created an Android keystore with Monaca Cloud IDE, please follow the instructions below to get a SHA-1 fingerprint of the KeyStore:

  1. From Monaca Cloud IDE menu, go to Configure → Android KeyStore Settings.

  2. Click on Export to download your KeyStore.

  3. Then, go to your command prompt and type:

    • <your-key-name> which is the alias of the downloaded KeyStore from Cloud IDE.

    • <path-to-production-keystore> which is the path to where you keep the downloaded KeyStore file.

    keytool -exportcert -alias <your-key-name> -keystore <path-to-production-keystore> | openssl sha1 -binary | openssl base64
  4. Then, you will be asked to input the password of the KeyStore.

Can't install my app on an iOS device after building it.

Please check whether the target device is registered in the provisioning profile selected at the time of building.

Last updated