Monaca Debugger for iOS

Monaca Debugger for iOS
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
The plugin below will not be installed on both the store version and the custom Monaca Debugger.
You can use these plugins in debug build or release build.
  • Monaca Backend plugin
  • Plugin for push notification
    • phonegap-plugin-push
    • onesignal-cordova-plugin
    • cordova-plugin-firebase
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:
  • upgrade Cordova version of your project
  • use Custom Monaca Debugger.
  • 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

    Preparation

    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 Build → Build App for iOS .

    2. Select Custom Debugger Build and choose Development provisioning profile. Then, click on Start Build.

    3. This may take sometimes until the build is completed. The following screen will appear after the build is successfully completed. Then, you can use the QR code to install the debugger on your device or download the built file to your PC.

    See Also: