Using the App Manager

  • Revision slug: Mozilla/Firefox_OS/Using_the_App_Manager
  • Revision title: Using the App Manager
  • Revision id: 468207
  • Created:
  • Creator: jryans
  • Is current revision? No
  • Comment

Revision Content

The Firefox App Manager lets you install apps from your computer to a WebApp capable device (Firefox OS), and debug any running app.

WARNING: Work in progress (both code and documentation). Tracking bugs: Firefox OS 1.2, and later. Firefox App Manager is available in Firefox 26. The device must run at least Firefox OS 1.2.

Connecting a device

Configuring the device

  1. Enable remote debugging in Firefox OS:
    Settings -> Device Information -> More Information -> Developer -> Remote Debugging [x]
  2. Plug the device into your computer
  3. It's recommended to disable the "Settings -> Screen Lock" option
  4. If you don't use the ADB Helper Add-on, enable port forwarding:
    adb forward tcp:6000 localfilesystem:/data/local/debugger-socket

ADB Helper Add-on

Using adb manually is not always simple. The ADB Helper makes the process easier. No need to install adb, no need to type the adb forward command. Everything is handled by the add-on. You can find the add-on on addons.mozilla.org (FIXME).

Start the App Manager

In Firefox Desktop:

Tools > Web Developer, select App Manager

Connect

Make sure your phone is unlocked and the adb forward command was successful.

Using the App Manager

Apps panel

From here, you can import an existing app from your computer, validate it, install it and debug it.

FIXME

Device panel

Installed Apps

From here, you can start an installed app and debug it.

FIXME

Permissions

List of permissions in the device.

FIXME

Simulator

Install simulator. FIXME

Troubleshooting

My device is not recognized

  • Make sure that your device runs at least Firefox OS 1.2
  • Did you enable "Remote Debugging" in the settings of your phone? (see the "Configuring Device" section)
  • If you are not using the ADB Helper add-on:
    • Did you run the adb forward command? (see the "Configuring Device" section)
  • If you are using the ADB Helper add-on:
    • If you use Linux, make sure to setup udev correctly
    • If you use Windows, make sure to install the appropriate drivers
  • Is your phone unlocked?

Revision Source

<p>The Firefox App Manager lets you install apps from your computer to a WebApp capable device (Firefox OS), and debug any running app.</p>
<p><strong>WARNING</strong>: Work in progress (both code and documentation). Tracking bugs: <a href="https://bugzilla.mozilla.org/showdependencytree.cgi?id=912913&amp;hide_resolved=1" title="https://bugzilla.mozilla.org/showdependencytree.cgi?id=912913&amp;hide_resolved=1">Firefox OS 1.2</a>, and <a href="https://bugzilla.mozilla.org/buglist.cgi?quicksearch=component%3A%22App%20Manager%22&amp;list_id=7838998" title="https://bugzilla.mozilla.org/buglist.cgi?quicksearch=component%3A%22App%20Manager%22&amp;list_id=7838998">later</a>. Firefox App Manager is available in <strong>Firefox 26</strong>. The device must run at least <strong>Firefox OS 1.2</strong>.</p>
<h2 id="Connecting_a_device">Connecting a device</h2>
<h3 id="Configuring_the_device"><a name="Configuring_device">Configuring the device</a></h3>
<ol>
  <li>Enable remote debugging in Firefox OS:
    <pre>
Settings -&gt; Device Information -&gt; More Information -&gt; Developer -&gt; Remote Debugging [x]</pre>
  </li>
  <li>Plug the device into your computer</li>
  <li>It's recommended to disable the "<code>Settings -&gt; Screen Lock</code>" option</li>
  <li>If you don't use the ADB Helper Add-on, enable port forwarding:
    <pre>
adb forward tcp:6000 localfilesystem:/data/local/debugger-socket</pre>
  </li>
</ol>
<h3 id="ADB_Helper_Add-on">ADB Helper Add-on</h3>
<p>Using <code>adb</code> manually is not always simple. The ADB Helper makes the process easier. No need to install <code>adb</code>, no need to type the <code>adb forward</code> command. Everything is handled by the add-on. You can find the add-on on <a href="https://addons.mozilla.org" title="https://addons.mozilla.org">addons.mozilla.org</a> (FIXME).</p>
<h3 id="Start_the_App_Manager">Start the App Manager</h3>
<p>In Firefox Desktop:</p>
<pre>
Tools &gt; Web Developer, select App Manager</pre>
<h3 id="Connect">Connect</h3>
<p>Make sure your phone is unlocked and the <code>adb forward</code> command was successful.</p>
<h2 id="Using_the_App_Manager">Using the App Manager</h2>
<h3 id="Apps_panel">Apps panel</h3>
<p>From here, you can import an existing app from your computer, validate it, install it and debug it.</p>
<p>FIXME</p>
<h3 id="Device_panel">Device panel</h3>
<h4 id="Installed_Apps">Installed Apps</h4>
<p>From here, you can start an installed app and debug it.</p>
<p>FIXME</p>
<h4 id="Permissions">Permissions</h4>
<p>List of permissions in the device.</p>
<p>FIXME</p>
<h2 id="Simulator">Simulator</h2>
<p>Install simulator. FIXME</p>
<h2 id="Troubleshooting">Troubleshooting</h2>
<h3 id="My_device_is_not_recognized">My device is not recognized</h3>
<ul>
  <li>Make sure that your device runs at least Firefox OS 1.2</li>
  <li>Did you enable "Remote Debugging" in the settings of your phone? (see the "Configuring Device" section)</li>
  <li>If you are not using the ADB Helper add-on:
    <ul>
      <li>Did you run the <code>adb forward</code> command? (see the "Configuring Device" section)</li>
    </ul>
  </li>
  <li>If you are using the ADB Helper add-on:
    <ul>
      <li>If you use Linux, make sure to setup udev correctly</li>
      <li>If you use Windows, make sure to install the appropriate drivers</li>
    </ul>
  </li>
  <li>Is your phone unlocked?</li>
</ul>
Revert to this revision