Решение проблем с WebIDE

Подключение устройства на Firefox OS по USB

Если вы пытаетесь подключить устройство на Firefox OS к WebIDE и его не видно, вот некоторые вещи, которые вы можете попробовать:

• Проверьте версию Вашей Firefox OS: Вы должны быть убедиться, что Ваше устройство работает под управлением Firefox OS 1.2/Boot2Gecko 1.2 или выше. Для того, чтобы это проверить, войдите в настройки приложений на устройстве, затем Информация > Программное обеспечение. Если ваша версия достаточно старая, найдите ваше устройство в руководстве разработчика и следуйте инструкциям по обновлению.
• Включите удалённую отладку: войдите в настройки приложений на устройстве, далее Для разработчиков > Отладка через USB.
  • В предыдущих версиях данная настройка включается в Информация > Подробная информация > Меню разработчика
  • Firefox OS 1.3 и ниже: "Удалённая отладка" это просто обычный флажок (checkbox). Отметьте флажок.
  • Firefox OS 1.4 и выше: "Удалённая отладка" попросит вас включиться только для ADB или для ADB и DevTools. Выберите "ADB и DevTools".
• Отключите блокировку экрана на вашем устройстве: в настройках на устройстве, войдите в Блокировка экрана и уберите флажок с Экран блокировки. Это хорошая идея, потому что, когда экран гаснет, соединение с телефоном обрывается, что означает, устройство больше недоступно для отладки.
• Убедитесь, что вы не подключились к Android устройству в то же время, когда Firefox OS устройство уже было подключено к вашему компьютеру.
• Проверьте USB-кабель, который вы используете:
  • Попробуйте отключить и снова включить USB-кабель.
  • Попробуйте подключить USB-кабель в другой порт на вашем компьютере
  • Попробуйте подключить другой USB-кабель. Кабели, которые идут в комплекте с телефоном, часто бывают плохого качества.
  • Попробуйте использовать более короткий USB-кабель. Длинные кабели, как известно, не работают так хорошо.
• Попробуйте выключить и снова включить удалённую отладку в настройках приложений на устройстве.
• Если у вас отключено дополнение ADB Helper, вы успешно запустили команду adb forward?
• Если вы используете Linux:
  • Убедитесь, что вы добавили файл правил udev, как описано в шаге 3 руководства настройки Android устройства. Аттрибут idVendor для Geeksphone равен "05c6", а эта страница содержит другие значения idVendor. Далее, запустите adb devices, что убедиться, что устройство присутствует в списке. Если устройство отображается "не разрешённым", вам нужно перезапустить adb сервер (например, adb kill-server;adb start-server).
• Если вы используете Windows:
  • Вам нужно установить драйвера, как описано в шаге 3 этого руководства настройки Android устройства. Вы можете найти драйвера для Geeksphone устройств на сайте Geeksphone и драйвера для устройств Google на сайте Google. Windows 8 по умолчанию не даёт вам устанавливать неподписанные драйвера. Смотрите это руководство "Как установить неподписанный драйвер на Windows 8".
  • Если WebIDE не удаётся увидеть ваше устройство после следующих шагов, вам может понадобиться отредактировать adb_usb.ini.
• Если вы используете OS X:
  • Если вы получаете ошибки тайм-аута и с эмуляторами, и с реальными устройствами, то возможно вам не удаётся подключиться к localhost из-за пустого файла /etc/hosts. Вы можете решить проблему заполнением файла и очисткой кеша DNS, как описано тут.
  • Если вы пользователь EasyTether, то вам понадобится удалить или отключить EasyTether: sudo kextunload /System/Library/Extensions/EasyTetherUSBEthernet.kext

Подключение к устройству Firefox OS по Wi-Fi

• Проверьте вашу версию: отладка по Wi-Fi требует Firefox 39 или выше, и Firefox OS устройство, работающее на сборке Firefox OS 3.0 от 27-03-2015 или позже.
• Компьютер с Firefox и Firefox OS устройство должны быть подключены к той же Wi-Fi сети
  • Точнее говоря, компьютер не может использовать проводное соединение, относящееся к тому же роутеру. Вместо этого, оба устройства должны быть подключены через Wi-Fi.

Подключение к Firefox для Android

Если вы пытаетесь подключиться к Firefox, работающему на Android OS и устройство не отображается, то вот несколько вещей, которые вы можете попробовать:

• Проверьте свою версию Firefox: убедитесь, что на вашем устройстве запущен Firefox 36 или выше. WebIDE не находит версии старее автоматически, так что вам понадобится включить проброску портов и подключиться к устройству - следуйте инструкциям здесь.
• Убедитесь, что вы включили удалённую отладку в Firefox: откройте Firefox для Android, откройте его меню, выберите Параметры, а затем отметьте галочку в Дополнительно > Удалённая отладка через USB.
• Убедитесь, что USB отладка разрешена в опциях разработчика на устройстве.
• Если вы всё ещё не видите своё устройство в окне WebIDE, попробуйте выключить и включить заново удалённую отладку на устройстве.
  • Отключите своё устройство от компьютера и выключите удалённую отладку на устройстве.
  • Заново подключите устройство и включите удалённую отладку - перезапустится отладчик на устройстве.
  • Попробуйте подключиться через WebIDE снова.
• Если вы используете Linux:
  • Убедитесь, что вы добавили файл правил udev, как описано в шаге 3 руководства настройки Android устройства. Список значений idVendor Android может помочь. Далее, запустите adb devices, что убедиться, что устройство присутствует в списке. Если устройство отображается "не разрешённым", вам нужно перезапустить adb сервер (например, adb kill-server;adb start-server).
  • Если вы используете android-tools-adb package из Debian, ADB Helper может вызывать закрытие сервера ADB. Этот пакет отключает TCP соединения с сервером, на который полагается ADB Helper.
• Если вы используете Windows:
  • Убедитесь, что ваше Android устройство разпознаётся корректно и использует Google USB Driver, который поставляется с Android SDK.
• Если вы используете Mac OS X:
  • Если вы пользователь EasyTether, вам понадобиться удалить или отключить EasyTether: sudo kextunload /System/Library/Extensions/EasyTetherUSBEthernet.kext

Подключение Firefox для Android по Wi-Fi

• Проверьте ваши версии Firefox: отладка по Wi-Fi требует Firefox 42 или выше, и Firefox для Android 42 или выше.
• Компьютер с Firefox и Android устройство должны быть подключены к той же Wi-Fi сети
  • Точнее говоря, компьютер не может использовать проводное соединение, относящееся к тому же роутеру. Вместо этого, оба устройства должны быть подключены через Wi-Fi.

Подключение к другим браузерам (Chrome, Safari)

WebIDE использует Valence (бывший Firefox Tools Adapter) для подключения к другим браузерам, например, Chrome and Safari.

При возникновении проблем с подключением к другим браузерам, проверьте настройки, а также примечания касаемо этих браузеров на странице Valence.

Не удаётся отладить некоторые приложения

Если вы понимаете, что вам не удаётся отладить сертифицированные приложения, встроенные приложения или приложения уже установленные на реальном устройстве, то вы вероятно столкнулись с ограниченными привилегиями политики безопасности WebIDE. Чтобы узнать больше, посмотрите раздел Unrestricted app debugging (including certified apps, main process, etc.).

Не удаётся загрузить список проектов

Если открыть WebIDE в одной версии Firefox, а потом откатиться до предыдущей версии Firefox с тем же профилем, вы можете увидеть сообщение об ошибке "не удается загрузить список проектов" при открытии WebIDE в предыдущей версии Firefox.

Это случается, когда система хранения данных, которую использует WebIDE (IndexedDB), требует переместить и реструктурировать внешние файлы для новой версии Firefox. Список проектов становится фактически недоступным для старых версий Firefox.

Данные не теряются, но вам придётся продолжить использовать самую новую версию Firefox, с которой использовался ваш профиль, чтобы получить список проектов обратно.

Если вы очень хотите использовать старую версию Firefox, вы можете попытаться удалить только список проектов следующим образом, но это не поддерживается и может привести к проблемам в дальнейшим или дополнительным потерям данных:

1. Закройте Firefox
2. Найдите вашу директорию профиля Firefox
3. Найдите папку storage внутри директории профиля
4. В некоторых местах этого древа файлов могут быть файлы и/или директории, которые начинаются с 4268914080AsptpcPerjo (хэшированное имя базы данных))

   • Например, они могут располагаться в <профиль>/storage/permanent/indexeddb+++fx-devtools/idb

5. Удалите все подобные файлы и директории
6. Запустите Firefox и WebIDE снова

Включить ведение журнала

Вы также можете включить подробное протоколирование для сбора диагностических данных:

1. Откройте about:config, и добавьте новый параметр, называемый [email protected] со значением all и установите [email protected] в true.
2. В дополнениях, отключите и заново включите дополнение ADB Helper.
3. Откройте Веб-консоль и вы увидите сообщения с префиксом adb. Если эти сообщения ничего для вас не значат, попросите помощи.

Получить помощь

Зайдите на IRC-канал #devtools, и мы постараемся вам помочь.