Revision 734923 of WebIDE Problemlösung

<h2 id="Connecting_a_Firefox_OS_device">Mit einem Firefox-OS-Gerät verbinden</h2>

<p>Wenn Du mit einem Firefox-OS-Gerät eine Verbindung zur WebIDE versuchst und Dein Gerät wird nicht angezeigt, prüfe folgendes:</p>

<ul>
 <li>Überprüfe die Version von Firefox OS:<br />
  Stell sicher, dass auf Deinem Gerät <strong>Firefox OS 1.2/ Boot2Gecko 1.2</strong> oder höher läuft. Um die Version zu prüfen, starte die SettingsApp (Einstellungen) und gehe nach&nbsp;<code>Device Information &gt; Software (Geräteinformationen &gt; Software)</code>. Wenn Deine Version zu alt ist, finde dein Gerät im <a href="/de/Firefox_OS/Developer_phone_guide">Developer Phone Guide</a> und folge den Anweisungen zum Upgraden.</li>
 <li>Erlaube das Remote Debugging (Entferntes debuggen):<br />
  In der SettingsApp (Einstellungen) gehe nach <code>Device Information &gt; More information &gt; Developer (Geräteinformation &gt; Weitere Informationen &gt; Entwickler).</code>sc
  <ul>
   <li>in Firefox OS 1.3 und früher: "Remote Debugging" ist eine einfach Checkbox - einfach anklicken.</li>
   <li>in Firefox OS 1.4 und später: "Remote Debugging" fragt ob nur ADB oder ADB und DevTools erlaubt werden sollen. Wähle hier "ADB und DevTools"</li>
  </ul>
 </li>
 <li>Deaktiviere das Abschalten des Bildschirms:</li>
 <li>Deaktivieren das Abschlaten des Bildschirms:<br />
  In den Einstellungen auf Deinem Gerät (Settings-App) gehe nach "Bildschrim sperren" und nimm das Häckchen raus. Warum: wenn der Bildschirm gesperrt wird, verliert das Gerät die Verbindung und steht für das Remote Debugging nicht mehr zur Verfügung.</li>
 <li>Achte darauf, daß kein anderes Android-Gerät zur selben Zeit mit dem Computer verbunden ist, ausser dem Firefox OS Gerät.</li>
 <li>Überprüfe das USB-Kabel:
  <ul>
   <li>Zieh das USB-Kabel raus und verbinde es erneut.</li>
   <li>Prüfe das Kabel an einem anderen Rechner und auch an anderen USB-Anschlüssen.</li>
   <li>Versuche ein anderes USB-Kabel. Die mit dem Gerät mitgelieferten Kabel sind meist von minderer Qualität und fallen of aus.</li>
   <li>Versuche ein kürzeres USB-Kabel. Es ist bekannt, daß längere Kabel nicht so gut arbeiten.</li>
  </ul>
 </li>
 <li>Deaktivere und Aktiviere erneut das Remote Debugging auf dem Firefox OS-Gerät.</li>
 <li>If <a href="/en-US/docs/Tools/WebIDE#Custom_runtimes">you disabled the ADB Addon Helper</a>, did you successfully run the <code>adb forward</code> command?</li>
 <li>If you use Linux:
  <ul>
   <li>Make sure you added add a <code>udev</code> rules file, as documented in step 3 of this guide to <a class="external external-icon" href="https://developer.android.com/tools/device.html#setting-up">setting up an Android device</a>. The <code>idVendor</code> attribute to use for the Geeksphone is "05c6", and <a class="external external-icon" href="https://developer.android.com/tools/device.html#VendorIds">this page</a> lists other <code>idVendor</code> values.</li>
  </ul>
 </li>
 <li>If you use Windows:
  <ul>
   <li>You need to install drivers, as documented in step 3 of this guide to <a class="external external-icon" href="https://developer.android.com/tools/device.html#setting-up">setting up an Android device</a>. You can find drivers for Geeksphone devices on the <a class="external external-icon" href="https://downloads.geeksphone.com/">Geeksphone web site</a> and drivers for Google devices on <a href="https://developer.android.com/sdk/win-usb.htm">Google web site</a>. Windows 8 by default will not let you install unsigned drivers. See this tutorial on <a class="external-icon external" href="https://www.craftedge.com/tutorials/driver_install_windows8/driver_install_win8.html" title="https://www.craftedge.com/tutorials/driver_install_windows8/driver_install_win8.html">"How to install an unsigned driver on Windows 8"</a>.</li>
   <li>If WebIDE can't see your device after following all the steps, you may have to <a class="external-icon external" href="https://blog.fh-kaernten.at/wehr/?p=1182">edit adb_usb.ini</a>.</li>
  </ul>
 </li>
 <li>If you use Mac OS X:
  <ul>
   <li>If you're getting timeout errors connecting to both simulators and real devices, you may be unable to connect to localhost due to an empty /etc/hosts file. You can solve the problem by populating the file and flushing DNS cache <a href="https://discussions.apple.com/thread/2729411?tstart=0">as described here</a>.</li>
   <li>If you're an EasyTether user, you will need to uninstall or disable EasyTether: <code>sudo kextunload /System/Library/Extensions/EasyTetherUSBEthernet.kext</code></li>
  </ul>
 </li>
</ul>

<h3 id="Unrestricted_debugging_(including_certified_apps.2C_built-in_apps.2C_apps_already_installed_on_a_device)">Unrestricted debugging (including certified apps, built-in apps, apps already installed on a device)</h3>

<p>If you are finding that you can't debug certified apps, built-in apps, or apps already installed on a real device, then you may be coming across WebIDE's restricted privileges security policy. To find out more, see the section on <a href="/en-US/docs/Tools/WebIDE#Unrestricted_app_debugging_%28including_certified_apps.2C_main_process.2C_etc.%29">Unrestricted app debugging (including certified apps, main process, etc.)</a>.</p>

<h2 id="Connecting_to_Firefox_for_Android">Connecting to Firefox for Android</h2>

<p>If you're trying to connect to a Firefox instance running on the Android OS and it doesn't show up, here are some things you can try:</p>

<ul>
 <li>Check your Firefox version: make sure your device is running<strong> Firefox 36 or higher</strong>. WebIDE will not detect older versions automatically, so you need to enable port forwarding and connect to the device port - follow the instructions <a class="external external-icon" href="https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging/Firefox_for_Android">here</a>.</li>
 <li>Make sure you have enabled remote debugging in Firefox: open Firefox for Android, open its menu, select <code>Settings</code>, and then check the checkbox at <code>Developer Tools &gt; Remote debugging</code>.</li>
 <li>Make sure that USB debugging is allowed in the device's developer settings</li>
 <li>If you still do not see your device in the WebIDE window, try toggling <code>Remote debugging</code> on the phone.
  <ul>
   <li>Disconnect your device from your computer and turn off <code>Remote debugging</code> on the phone.</li>
   <li>Reconnect the device and turn on <code>Remote debugging</code> - this restarts the debugger instance on the phone.</li>
   <li>Try connecting via WebIDE again.</li>
  </ul>
 </li>
</ul>

<h2 id="Connecting_to_other_browsers_(Chrome.2C_Safari)">Connecting to other browsers (Chrome, Safari)</h2>

<p><a class="here" href="https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging/Firefox_for_Android">WebIDE makes use of </a><a href="/en-US/docs/Tools/Firefox_Tools_Adapter">Valence (formerly Firefox Tools Adapter)</a> to reach other browsers, like Chrome and Safari.&nbsp;</p>

<p>If you are having trouble connecting to these other browsers, check the setup steps and other notes for those browsers on the <a href="/en-US/docs/Tools/Firefox_Tools_Adapter">Valence page</a>.</p>

<h2 id="Unable_to_load_project_list">Unable to load project list</h2>

<p>If you open WebIDE in one version of Firefox, and then downgrade to a previous Firefox version with the same profile, you may see the error "Unable to load project list" when opening WebIDE in the earlier Firefox version.</p>

<p>This can occur when the storage system that WebIDE uses (<a href="/en-US/docs/Web/API/IndexedDB_API">IndexedDB</a>) needs to move or restructure its internal files for the newer Firefox version. The project list then becomes effectively inaccessible to older versions of Firefox.</p>

<p>No data has been lost, but you will need to keep using the newest version of Firefox that was used with your profile to get the project list back.</p>

<p>If really want to use the older version of Firefox, you can attempt to delete just the project list in the following way, but this is unsupported and could result in the further problems or additional data loss:</p>

<ol>
 <li>Close Firefox</li>
 <li>Find your Firefox profile directory</li>
 <li>Find the <code>storage</code> folder inside the profile directory</li>
 <li>Under some part of this file tree, there should be files and/or directories that start with <code>4268914080AsptpcPerjo</code> (a hashed name of the database)</li>
 <li>Remove any such files and directories</li>
 <li>Start Firefox and WebIDE again</li>
</ol>

<h2 id="Enable_logging">Enable logging</h2>

<p>You can also enable verbose logging to gather diagnostics:</p>

<ol start="1" style="list-style-type: decimal;">
 <li>Open <a class="external external-icon" href="https://kb.mozillazine.org/About:config">about:config</a>, and add a new preference called <code>[email protected]</code>, with the string value <code>all</code>, and set <code>[email protected]</code> to <code>true</code>.</li>
 <li>In the <a class="external external-icon" href="https://support.mozilla.org/en-US/kb/disable-or-remove-add-ons">Add-ons Manager</a>, disable and then re-enable the ADB Helper add-on.</li>
 <li>Open the <a href="https://developer.mozilla.org/en-US/docs/Tools/Browser_Console">Browser Console</a> and you'll now see console messages prefixed with <code>adb</code>. If the messages don't mean anything to you, <a href="/en-US/docs/Tools/WebIDE/Troubleshooting#Get_help">ask for help</a>.</li>
</ol>

<h2 id="Get_help">Get help</h2>

<p>Go to the <a class="external external-icon" href="https://wiki.mozilla.org/DevTools/GetInvolved#Communication">#devtools room on IRC</a> and we will try to help.</p>