Monaca Debugger for iOS

Monaca Debugger for iOS
Monaca Backend plugin is not included in both Monaca Debugger (store version) and Custom Monaca Debugger.
    If the Cordova version of your project is lower than 5.2, it might not work properly with Monaca Debugger 5.X.X. There are two ways to fix this issue:
  1. upgrade Cordova version of your project
  2. use Custom Monaca Debugger.
Monaca Debugger (Store Version) Custom Monaca Debugger
Description Monaca Debugger available at the store Monaca Debugger built from Monaca Cloud IDE
Installation App Store Refer to Build and Install Custom Monaca Debugger
Cordova Plugins Core and some third-party Cordova plugins are automatically included. In addition to the core and third-party Cordova plugins, user submitted plugins (of the current project) are included.
App ID (iOS:CFBundleIdentifier) mobi.monaca.debugger App ID set by a user
Version Name (iOS:CFBundleShortVersionString) Fixed (currently 6.0.0) Display version name set by a user
App Version (iOS:CFBundleVersion) Fixed (currently 6.0.0) Version set by a user
USB Debugging Not Available Available (Safari’s Web Inspector)
Localkit Inspector Function Not Available Available
Network Install Not Available Available

Cordova Plugins

In Monaca Debugger, core and third-party Cordova plugins are automatically included.

Monaca includes Core cordova plugins which are a minimal set of APIs such as Battery Status, Camera, Contacts, Device and so on. For a complete list of core Cordova plugins, please refer to Core Cordova Plugins.

Monaca also includes some third-party Cordova plugins such as Statusbar, DatePicker, BarcodeScanner and so on. For a complete list of currently included third-party Cordova plugins, please refer to Third-party Cordova Plugins.

While developing your project, you may need to add other third-party or custom Cordova plugins to your project. The standard Monaca Debugger (Store Version) doesn’t have these newly added plugins. For this reason, your project might not run properly in the debugger. Therefore, you need to use Custom Monaca Debugger. Custom Monaca Debugger is a debugger which is built from a Monaca Project within Monaca Cloud IDE. Please refer to Build and Install Custom Monaca Debugger.

USB Debugging

Monaca Debugger for iOS supports USB debugging functions with Safari browser such as:

  • console debugging: using console to diplay message.
  • DOM inspection: viewing and modifying DOM structure with live updates.
  • JavaScript debugging: profiling JavaScript performance, setting breakpoint and execution control.

For more information, please refer to USB Debugging with Monaca Debugger for iOS Apps.

Localkit Inspector Function

Inspector can be used when developing either on Windows or Mac OS.

Network Install

Network Install is a feature provided by Custom Monaca Debugger for iOS allowing you to install the built app (debug build only) using the debugger. For more information, please refer to how to use Network Install feature.

This feature is not available for Monaca Debugger for iOS available at App Store.

How to Build Custom Monaca Debugger


You are required to have:

  • a valid private key
  • Developer certificate
  • Development provisioning profile

Please refer to Building an iOS App (Step 1 and Step 2) on how to get the above items and make necessary configurations before start building the custom debugger. After obtaining the above necessary files, start building with the following instruction:

Start Building

  1. From Monaca Cloud IDE menu, go to Debug → Setup Monaca Debugger .
  2. Select Debugger for iOS → Build and Install .

  3. Upload the development provisioning profile and click Next button.

  4. This may take sometimes until your building is completed. The following screen will appear after the build is successfully completed. Then, you can download the built file to your PC and install it to your iOS device using iTune.

  5. After installing the debugger on your device, sign in with your Monaca account. Then, tick I've installed Monaca Debugger and logged in and click Next.

  6. Monaca Cloud IDE will then try looking for the debugger. Once it’s found and connected, click Run on Device to start running the current app in your debugger right away.

  7. By now your app should be running in your debugger. Try testing your app in the debugger and making some changes in the IDE. You will be able to see the changes reflected in the debugger once you save the changes.

See Also: