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.
WebIDE is deprecated. To debug in Firefox 68 and later, follow the instructions on about:debugging.
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.
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
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
To setup your Android device you need to enable USB debugging on the device and in Firefox.
Enable USB debugging
Follow steps 1 and 2 of this link only to enable USB debugging on your Android device.
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"||
|version 42 to 44||select "Developer tools", then "Remote debugging via USB"||
|version 45 or later||select "Advanced", then "Remote debugging via USB"||
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":
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.
If you're having trouble getting this to work, check the Troubleshooting page for things to double check and support forums you can contact.