This article describes how to connect the Firefox Developer Tools to Firefox for Android from Firefox 36 onwards. For connecting over WiFi, see corresponding page.

It's been possible for a long time to connect the Firefox Developer Tools to Firefox for Android so you can debug your mobile website. Until now, this was a fairly complex and error-prone process. From Firefox 36 we've made the process much simpler: in particular, you don't need to deal directly with the adb tool at all. Now you connect using WebIDE, which takes care of setting up adb behind the scenes.

For this to work, you need at least Firefox 36 on the desktop and Firefox 35 on the mobile device. If you need to use an earlier version, see the older instructions for connecting the developer tools to Firefox for Android.

WebIDE's project management and installation features aren't available here, as they currently only work with Firefox OS devices. On Android devices, only existing websites already loaded into the browser can be debugged.

 

This guide's split into two parts: the first part, "Prerequisites" covers stuff you only need to do once, while the second part, "Connecting", covers stuff you need to do each time you connect the device.

Prerequisites

First, you'll need:

  • a desktop or laptop computer with Firefox 36 or higher running on it
  • an Android device capable of running Firefox for Android with Firefox for Android 35 or higher running on it
  • a USB cable to connect the two devices

ADB Helper

Your desktop Firefox also needs to have the ADB Helper add-on, version 0.7.1 or higher. This should be installed for you automatically the first time you open WebIDE. To check the version, type about:addons into the browser's address bar and you should see ADB listed.

If you don't have ADB Helper version 0.7.1 or higher, select "Manage Extra Components" from the "Projects" menu, and you'll see the "Extra Components" window, which will contain an entry for ADB Helper:

Click "uninstall" then "install", and you should now have the latest version.

Setting up the Android device

First, enable USB debugging by following steps 2 and 3 of this link only.

Next, enable remote debugging in Firefox for Android. Open the browser, open its menu, select "Settings" (on some Android devices you may need to select "More" to see the "Settings" option), then this depends on your browser version:

  • version 36 to 41: select "Developer tools", then "Remote debugging"

How to enable remote debugging on Firefox on Android v36-41

  • version 42 to 44: select "Developer tools", then "Remote debugging via USB"

How to enable remote debugging on Firefox on Android v42-44

  • version 45 or later: select "Advanced", then "Remote debugging via USB"

How to enable remote debugging on Firefox on Android v45 or later

Connecting

Connect the Android device to the desktop with the USB cable, and open WebIDE. Select "Firefox for Android" listed as a debugging target under "USB DEVICES":

On the Android device, you'll now see a warning message. Depending on your version, click "OK" or "Allow":

Incoming connection warning v36-41

Incoming connection warning v42 or later

Now click the "Open App" menu in WebIDE. You'll see a list of all the tabs open on the device:

Select a tab to attach the developer tools to it:

Now you should be able to use all the Firefox developer tools that support remote debugging. See the page on remote debugging for more details.

When finished, for security reason, you might disable Android's USB debugging and Firefox's remote debugging by reverting the process above.

Document Tags and Contributors

Tags: 
 Last updated by: korrawitp,