This guide explains how to connect the Firefox Developer Tools to a Firefox OS device over USB.
Before you can connect a Firefox OS device, there's some setup you have to go through:
- Check your Firefox OS version: Make sure your device is running Firefox OS 1.2/Boot2Gecko 1.2 or higher. To check the version, go to the Settings app on the device, then
Device Information > Software. If you don't have a high enough version, find your device in the developer phone guide and follow the instructions for upgrading.
- Enable remote debugging: In the Settings app on the device, go to
Device information > More information > Developer.
- Firefox OS 1.3 and earlier: "Remote Debugging" is just a simple checkbox. Check it.
- Firefox OS 1.4 and later: "Remote Debugging" asks you to enable for just ADB, or for ADB and DevTools. Select "ADB and DevTools".
- Disable Screen lock on your device: In the Settings app on the device, go to
Screen Lockand uncheck the
Lock Screencheckbox. This is required because when the screen gets locked, the phone connection gets lost, meaning it is no longer available for debugging.
- If you want unrestricted debugging privileges, including certified apps, built-in apps, and apps already installed on a real device: See the section on Unrestricted app debugging (including certified apps, main process, etc.).
- You need to install drivers, as documented in step 3 of this guide to setting up an Android device. You can find drivers for Geeksphone devices on the Geeksphone web site. Windows 8 by default will not let you install unsigned drivers. See this tutorial on "How to install an unsigned driver on Windows 8".
- If WebIDE can't see your device after following all the steps, you may have to edit adb_usb.ini.
If there are any other Android devices connected to your computer, disconnect them.
Now connect the device to the computer using USB, and open WebIDE. You should see the device appear in the Select Runtime menu under "USB DEVICES":
If you don't see your device, see the Troubleshooting page.
If you do see the device, select it, and you'll be able to connect the developer tools to it.