Platform-specific details of app installation Redirect 1

You don't have to do anything special to install apps on different platforms. All the information you need to provide, such as the app name, is contained in the app manifest. Here are some platform-specific details about how apps are installed on each platform. These details assume that Firefox has been installed on the platform.

Firefox OS (Boot to Gecko)

Gaia (the Firefox OS user interface) includes a marketplace link on the second homepage, and apps can be installed in this way. Default apps included with Gaia are stored in the Gecko profile on the device as an offline cache of the Web app at /data/local/OfflineCache/*.

If you want to browse this folder to look at the contents, you can do so using the adb tool:

$ adb shell ls -la /data/local/OfflineCache/

All other installed apps are stored in the DOM Registry component (you can find this file at /data/local/webapps). If they use appcache, the appcache will be populated at install time.

Windows

The following are created upon installation. All of these will be removed by the uninstaller (find it in the Windows Control Panel).

  • Shortcut on the current user's desktop.
  • Shortcut in Start menu > Programs for the current user.
  • Registry entries to make the app appear in the Control Panel's "uninstall a program" menu.
  • Folders for the app under %APPDATA%\scheme;domain[;port]
    • Where scheme is http or https, domain is the app's domain name, and port is a port number, used only if the default port number is not used.
    • Example folder name: C:\Users\myuser\AppData\Roaming\https;mozqa.com;115
    • The folders contain a stub executable (exe), configuration files, and an uninstaller.

When launched, each app has its own window with the following attributes:

  • A native menu bar (currently with File and Edit menus).
  • The title of the window is the name of the app.
  • System menu icon (in the upper left corner of the window) is specified by the app manifest.
  • The displayed Taskbar icon is also specified by the app manifest.

Each app runs in a separate process, and the app appears under its own name on the Applications tab of Task Manager. The executable name of the app (for example, "Mozilla QA WebRT Tester.exe") is the app name with illegal Windows filename characters removed.

Each app has its own profile with separate preferences, cookies, history, certificate authority settings, proxy settings, etc. Upon first run, profile data is created in the directory mentioned above, and in an equivalent directory in %LOCALAPPDATA%. Profile data is not removed by the uninstaller.

Mac OS X

Apps are installed into /Applications.

Opening the app launches the app in its own window minus the browser window frame. Apps execute using the Firefox binary. Each app runs in a separate process. Each app has its own profile, with separate preferences, cookies, certificate authority settings, proxy settings, etc.

Android

The installation creates an icon on the home screen. The app will not be added to the application list that is available from the Settings menu on the Android device.

Linux

Apps are installed directly in the $HOME of the user. For example if an app comes from http://areatweet.com/ it will get installed in $HOME/.http\;areatweet.com/.

The installation creates also a new entry in the desktop menu according to the Freedesktop specifications. It works on every desktop following the Freedesktop specifications such as KDE and Gnome.

The new entry is located in the $HOME/.local/share/applications/ directory of the user.

In KDE the new entry appears in an "Found Objects" menu group of the "Application" menu.

In Gnome the new entry appears in an "Others" menu group of the "Application" menu, see the screenshot.

Document Tags and Contributors

Last updated by: Sheppy,