Monaca Docs
Search…
Monaca
Release Notes and Updates
Product Guides
Tutorials
API Reference
Samples & Tips
Features
FAQ
General
IDE
Build
Release
Subscription
Application
Usage
Debugger
Supported Environments
Trouble Shooting
Monaca Product Website
日本語
Powered By GitBook
Debugger

Monaca Debugger is an application for debugging that can check the functionality of the app on an actual device without building. When using Monaca Debugger, any changes made to the code immediately reflect to the actual running device. No build and run process are required. This would help to speed up the development and testing process. For more details, please refer to Monaca Debugger.

The app operations on Monaca Debugger may differ from the ones on the actual device. After building and installing the app, it is necessary to check its icon, installation and operations without Monaca Debugger. Moreover, the app works more slowly on Monaca Debugger than the built apps because of the connection to the Monaca Cloud IDE.

Monaca provides utility to check the display and operations of application which is the Live Preview feature on the Monaca Cloud IDE. In addition, you can check application operations on the device prior to building by using Monaca Debugger. Both are very useful tools for improving development efficiency, so please make the most use of them.

For some devices, such as devices from HTC, there are confirmed cases of which the debug log cannot be displayed. If possible, please inform us of any information about devices that have such problem via Monaca Support, we will look into it and provide the solution as soon as possible.

There may have problems of configuration in AndroidManifest.xml file. If you use PhoneGap, please make sure to have this setting:
<uses-permission android:name=”android.permission.ACCESS_NETWORK_STATE”></uses-permission>
For details, please refer to Android Configuration.

Please try to reinstall Monaca Debugger. If it is still not working, please contact us.

While reading external JavaScript or CSS codes, there is a possibility that they are not readable for some reasons such as requirement for an authentication.

The following issues are the common issues and solutions when logging in Monaca Debugger:
  • If your password consists of non-alphanumeric character(s). Please
    change your password to alphanumeric character only.
  • Please check your Internet connection.
  • The email address was auto-completed. Please manually input the
    email address and password.

In some cases, Monaca Debugger may assume the exceptions occur internally by the external JavaScript library as errors. As long as the errors do not stop the functionality of your app, it should be fine to ignore them. Please note that in the built version, these errors should not occur when running on actual device.

Here are some important differences:
  1. 1.
    Where you download the debugger: Monaca Debugger can be downloaded
    from application markets. Custom build debugger can be installed
    from Monaca IDE.
  2. 2.
    Plugins included in the debugger: Monaca Debugger contains all core
    Cordova plugins. Custom build debugger will contain the plugins user
    submitted from Cordova Plugins configuration page.
  3. 3.
    USB debugging support (iOS Only): For iOS devices, USB debugging can
    be only enabled when the app is debug built. Therefore, you cannot
    do USB debugging on Monaca Debugger downloaded from App Store. For
    more details, please see Monaca Debugger for iOS.

We are providing 3 different ways to debug your application.
  1. 1.
    Debug using preview panel
  2. 2.
    Debug using Monaca Debugger with Monaca IDE (Weinre)
  3. 3.
    Debug using Monaca Debugger with USB debugging
For more details, please refer to Debugger's Usage.

Network installation is a way to install your debug or ad-hoc built app to your devices from Monaca Debugger. For more details, please refer to Network Install for Android or Network Install for iOS.​

When you make changes to your project but those changes are not updated in the project on Monaca Debugger, please try the following steps:
  • Make sure that you are using the latest version of Monaca Debugger.
  • Reset Monaca Debugger.
In order to reset Monaca Debugger, please do as follows:
  1. 1.
    Clear temporary files on the debugger:
    • For Android:
      • From Monaca Debugger menu, go to Debugger Settings.
      • Click on CLEAR SYNCED FILES and CLEAR STORAGE DATA buttons.
    • For iOS
      • From Monaca Debugger menu, go to Settings.
      • Click on Clear Temporary Files and Clear Local Storage buttons.
  2. 2.
    Log out of the debugger.
  3. 3.
    Log in again.
If the issue still persists, please contact our Monaca Support.

If console.log doesn't work for Cordova 7.1 or later projects, check the following:
  1. 1.
    Please use the latest version of Monaca Core Utility. Monaca Core Utility can be updated by following the steps below.
    1. 1.
      Go to Config → Manage JS/CSS Components.
    2. 2.
      Remove Monaca Core Utility component.
    3. 3.
      Then, re-add the component by clicking on Add button of Monaca Core Utility.
    4. 4.
      Select the latest version and click on Install button.
    5. 5.
      Click on Save button.
  2. 2.
    <!DOCTYPE HTML> in index.html must be set in uppercase. If it is set in lowercase, update it to uppercase.
Previous
Usage
Next
Supported Environments
Last modified 1yr ago
Copy link
On this page
What is the Monaca Debugger?
Are the operations of an app on the Monaca Debugger the same as when the app is installed on an actual device?
Before building, can I check application operations during development?
The debug log is not displayed.
When I started the app on Android, the app crashed.
Monaca Debugger is not working.
I cannot use CSS and JavaScript files in Live Preview.
Cannot log in to Monaca Debugger.
JavaScript error when loading Angular.js or other external library.
What is the difference between Monaca Debugger and its custom build version?
How can I debug my application?
What is a network install?
Changes are not updated in a project on Monaca debugger.
console.log is not working for Cordova 7.1 or later project