Monaca Debugger for iOS¶
Table of Contents
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:
|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 How to Build 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)||
||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|
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, Bluetooth 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 How to Build Custom Monaca Debugger.
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.
For more information, please refer to USB Debugging with Monaca Debugger for iOS Apps.
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.
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:
- From Monaca Cloud IDE menu, go to .
- Select .
- Upload the development provisioning profile and click Next button.
- 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.
- 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.
- 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.
- 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.