Usage

On this page, we will describe how to use Monaca Debugger with Monaca Cloud IDE and Monaca local development tools Monaca Localkit and Monaca CLI.

Before starting, please install Monaca Debugger on your device or emulator. Please refer to for more information.

Monaca Debugger with Monaca Cloud IDE

There are 2 main debugging functionalities that can be used to debug Monaca apps with the Monaca Cloud IDE:

Monaca Debug Panel: DOM inspection and console debugging.
USB Debugging: DOM inspection, console and JavaScript debugging.

Monaca debug panel

A popular web debugging tool, , is embedded in the debug panel of the Monaca Cloud IDE. This tool allows you to debug your app using console debugging and DOM inspection.

To start debugging your app by using Monaca Debugger with Monaca Cloud IDE, follow these instructions:

Open a project in the Monaca Cloud IDE.
Run the project in the Monaca Debugger.
Make sure your device is connected with the IDE. If your device appears in the debug panel, it is successfully connected to the IDE (see the screenshot below). Otherwise, please refresh the IDE or debugger until the connection is successfully made.

4. After your device is connected to the IDE, you can start debugging your app.

Console debugging

Console API allows you to write and display messages to the console using Javascript.

Here are some commonly used commands to log text in the console:

console.log(): displays a message to the console.
console.debug(): displays a message on the debug level (you can see
the message in the debug tab).
console.warn(): displays a message with a yellow warning icon.

Here is an example of using the console API:

Copy and paste the following code to the index.html file.

<!DOCTYPE HTML>
<html>
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, height=device-height, initial-scale=1, maximum-scale=1, user-scalable=no">
    <script src="components/loader.js"></script>
    <link rel="stylesheet" href="components/loader.css">
    <link rel="stylesheet" href="css/style.css">
    <script>
        var a = 1;
        var b = 2;

        function debug(){
            var c = a + b;
            console.log("debug() function is executed!");
            console.log("executed! variable c is " + c);
        }

        debug();
    </script>
</head>
<body>
    <h1>Hello World!</h1>
</body>
</html>

2. Save the code and connect the Monaca Debugger with the Monaca Cloud IDE. Run the project in the Monaca Cloud IDE. Now you can see the messages on the debug panel in the Monaca Cloud IDE and in the app log inside the Monaca Debugger.

3. The debug panel allows you to see the error log of your app as well.

DOM inspection

DOM (Document Object Model) inspection allows you to:

view the DOM structure of the currently active page.
modify the DOM structure as well as the CSS of the page with live
update.

USB debugging

With USB debugging, you can:

Console debugging: use the console to display messages and set debugging
sessions.
DOM inspection: view and modify DOM structures with live updates.
JavaScript debugging: profile JavaScript performance, set
breakpoint and use the execution control.

There are two ways to implement USB debugging depending on what kind of device you use:

Prerequisites for USB debugging with Monaca

Platform

iOS

Android

Monaca Debugger

Install driver

On Mac OS X, the necessary drivers should be already installed. The system will automatically find the device without any installation.

On Windows, you need to check the device manufacturer to find an appropriate driver for the device.

Enabling USB debugging

Enable the web inspector on an iOS device:

Go to Settings ‣ Safari
Scroll down and select Advanced.
Switch on Web Inspector.

Enable USB debugging on an Android device:

Go to Settings ‣ More
Select Developer options.
Tick USB Debugging.

Trust connection

The connected device should be displayed if you trust the host computer. Please trust the computer in order to get connected.

Safari remote debugging (for iOS and Mac only)

Connect your iOS device to your Mac via a USB cable.
Run your Monaca project in its custom built debugger.
Open Safari app and go to the Develop menu. Your iOS device’s name should show in the list. You can see the available pages of the Monaca app from the submenu of the device. Select the one you want to open.

Chrome remote debugging (for Android with Google Chrome browser)

Connect your Android device to your PC via a USB cable.
Run your Monaca project in the Monaca Debugger.
In the Chrome address bar, enter chrome://inspect/.
The Devices page appears as shown below. Your connected Android device should show there. Click inspect.