Apps/WebRT: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
m (→‎Overview: link mozApps, can't find good links for the others)
(update to incorporate Android runtime and fix outdated info)
Line 1: Line 1:
= Desktop WebRT =
= Web Runtime =


== Overview ==
== Overview ==


Desktop WebRT is a project to build a desktop Web application RunTime that provides webapps with a native-like look and feel along with platform integration APIs on Windows, Mac, and other desktop platforms.
The Web Runtime project builds application runtimes that enable users to install and run Open Web Apps on Android, Windows, Mac, and Linux.
 
The runtime comprises the [[mdc:Web/API/window.navigator.mozApps|navigator.mozApps DOM API]] through which the Mozilla Marketplace, other webapp stores, and webapps themselves request installation; an '''installer feature of Firefox''' that installs webapps on the native platform; a '''stub executable launcher''' bundled with Firefox that the installer copies to an appropriate location for each webapp it installs; and a '''xulapp shell''' that loads a webapp when a user starts it.
 
== Feature Drivers ==
 
The feature drivers are responsible for making sure the runtime gets completed and shipped with Firefox. They triage bug reports and enhancement requests, find engineers to tackle issues, and communicate status updates to the Apps initiative and Mozilla community.
 
The feature drivers are:
 
* Vishy Krishnamoorthy (vishy), Product Manager
* Bill Walker (bwalker), Engineering Manager
* Jason Smith (jsmith), QA Engineer
* Myk Melez (myk), Technical Lead


== Discussions ==
== Discussions ==
Line 22: Line 9:
Discussions on runtime design and development topics take place in a variety of public forums:
Discussions on runtime design and development topics take place in a variety of public forums:


* [http://chat.mibbit.com/?channel=%23mobile&server=irc.mozilla.org #mobile channel on irc.mozilla.org]
* [http://chat.mibbit.com/?channel=%23openwebapps&server=irc.mozilla.org #openwebapps channel on irc.mozilla.org]
* [http://chat.mibbit.com/?channel=%23openwebapps&server=irc.mozilla.org #openwebapps channel on irc.mozilla.org]
* [http://www.mozilla.org/about/forums/#mobile-firefox-dev mobile-firefox-dev discussion forum]
* [http://www.mozilla.org/about/forums/#dev-webapps dev-webapps discussion forum]
* [http://www.mozilla.org/about/forums/#dev-webapps dev-webapps discussion forum]
* [[Apps/StatusMeetings/Engineering|weekly Apps Engineering meeting]]
* [[Mobile/Notes|Mobile weekly meeting]]
 
Status updates are also presented at the weekly [[Firefox/Planning|Product Coordination]] and [[Platform#Meetings|Firefox/Gecko Development]] meetings.


== Bug Reporting ==
== Bug Reporting ==


Bugs related to the runtime are typically filed in the following three components:
File bugs on the Android runtime into the [https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox%20for%20Android&component=Web%20Apps Firefox for Android/Web Apps] component. File bugs on the desktop runtime into the [https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox&component=Web%20Apps Firefox/Web Apps] component.  And file bugs on the Open Web Apps (i.e. mozApps) API into the [https://bugzilla.mozilla.org/enter_bug.cgi?product=Core&component=DOM:%20Apps Core/Dom: Apps] component.
 
* [https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox&component=Webapp%20Runtime Firefox/Webapp Runtime]: the stub executable launcher (i.e. the binary and related files that Firefox creates for each webapp you install to your local computer) and the XUL shell (i.e. the XULRunner application that the launcher uses to load a webapp and provide it with native integration APIs)
* [https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox&component=Web%20Apps Firefox/Web Apps]: Firefox's webapp installer (i.e. the feature that creates a launcher when the user approves an installation request)
* [https://bugzilla.mozilla.org/enter_bug.cgi?product=Core&component=DOM:%20Mozilla%20Extensions Core / DOM: Mozilla Extensions]: Gecko's navigator.mozApps DOM API (i.e. the API that web pages use to request webapp installation)
 
== Triage ==
 
Drivers triage bug reports on a regular basis using the following queries for open bugs of various kinds, mostly in Firefox's ''Web Apps'' and ''Webapp Runtime'' components.
 
=== All Components ===
 
* [https://bugzilla.mozilla.org/buglist.cgi?order=assigned_to,bug_id;resolution=---;status_whiteboard_type=allwordssubstr;status_whiteboard=%5Bblocking-webrtdesktop1%2B%5D open <nowiki>[blocking-webrtdesktop1+]</nowiki>] (blocks the first release of the feature)
* [http://bit.ly/MFpVX4 open <nowiki>[Desktop WebRT]</nowiki>] (related bugs in other components)
 
=== Web Apps/Webapp Runtime Components ===
 
* [https://bugzilla.mozilla.org/buglist.cgi?priority=--;order=Bug%20Number;resolution=---;component=Web%20Apps;component=Webapp%20Runtime;product=Firefox open unprioritized]
* [https://bugzilla.mozilla.org/buglist.cgi?keywords=productwanted%20qawanted%20meta;keywords_type=nowords;priority=--;resolution=---;component=Web%20Apps;component=Webapp%20Runtime;product=Firefox;order=bug_id open unprioritized, excluding ''productwanted'', ''qawanted'', and ''meta'']
* [https://bugzilla.mozilla.org/buglist.cgi?priority=P1;priority=P2;priority=P3;priority=P4;priority=P5;order=priority,bug_id;resolution=---;component=Web%20Apps;component=Webapp%20Runtime;product=Firefox open prioritized]
* [https://bugzilla.mozilla.org/buglist.cgi?keywords=productwanted;keywords_type=allwords;order=Bug%20Number;product=Firefox;component=Web%20Apps;component=Webapp%20Runtime productwanted]
* [https://bugzilla.mozilla.org/buglist.cgi?keywords=uiwanted;keywords_type=allwords;product=Firefox;component=Webapp%20Runtime;component=Web%20Apps uiwanted]
* [https://bugzilla.mozilla.org/buglist.cgi?keywords=checkin-needed;keywords_type=allwords;product=Firefox;component=Webapp%20Runtime;component=Web%20Apps checkin-needed]
* [https://bugzilla.mozilla.org/buglist.cgi?order=Bug%20Number;list_id=3772980;field0-0-0=cf_status_firefox16;resolution=---;resolution=FIXED;query_format=advanced;type0-0-0=equals;value0-0-0=affected;component=Web%20Apps;component=Webapp%20Runtime;product=Firefox Firefox 16 - Desire to Fix and Uplift to Aurora]


== Source Code ==
== Source Code ==
Line 59: Line 23:
The source code for the runtime lives in the [http://hg.mozilla.org/mozilla-central/ mozilla-central Mercurial repository] in the following files and directories:
The source code for the runtime lives in the [http://hg.mozilla.org/mozilla-central/ mozilla-central Mercurial repository] in the following files and directories:


* [https://mxr.mozilla.org/mozilla-central/source/webapprt/ /webapprt]: stub executable launcher and XUL shell
* [https://mxr.mozilla.org/mozilla-central/source/mobile/android/modules/WebappManager.jsm /mobile/android/modules/WebappManager.jsm]: Android installer
* [https://mxr.mozilla.org/mozilla-central/source/browser/modules/webappsUI.jsm /browser/modules/webappsUI.jsm]: Firefox webapp installation UI
* [https://mxr.mozilla.org/mozilla-central/source/mobile/android/base/webapp/ /mobile/android/base/webapp/]: Android native integration
* [https://mxr.mozilla.org/mozilla-central/source/browser/modules/WebappsInstaller.jsm /browser/modules/WebappsInstaller.jsm]: Firefox webapp installer
* [https://mxr.mozilla.org/mozilla-central/source/browser/modules/WebappManager.jsm /browser/modules/WebappManager.jsm]: desktop installer
* [https://mxr.mozilla.org/mozilla-central/source/toolkit/webapps/ /toolkit/webapps/]: desktop native integration
* [https://mxr.mozilla.org/mozilla-central/source/webapprt/ /webapprt]: desktop stub executable launcher and shell
* [https://mxr.mozilla.org/mozilla-central/source/dom/apps/ /dom/apps]: Gecko navigator.mozApps DOM API
* [https://mxr.mozilla.org/mozilla-central/source/dom/apps/ /dom/apps]: Gecko navigator.mozApps DOM API


Engineers develop it in accordance with standard Mozilla development best practices, including the [https://developer.mozilla.org/En/Mozilla_Coding_Style_Guide Coding Style Guide], the [https://developer.mozilla.org/En/Developer_Guide/Committing_Rules_and_Responsibilities Committing Rules and Responsibilities], and Firefox's [[RapidRelease|rapid release schedule]].
Engineers develop it in accordance with standard Mozilla development best practices, including the [https://developer.mozilla.org/En/Mozilla_Coding_Style_Guide Coding Style Guide], the [https://developer.mozilla.org/En/Developer_Guide/Committing_Rules_and_Responsibilities Committing Rules and Responsibilities], and Firefox's [[RapidRelease|rapid release schedule]].

Revision as of 17:28, 17 June 2014

Web Runtime

Overview

The Web Runtime project builds application runtimes that enable users to install and run Open Web Apps on Android, Windows, Mac, and Linux.

Discussions

Discussions on runtime design and development topics take place in a variety of public forums:

Bug Reporting

File bugs on the Android runtime into the Firefox for Android/Web Apps component. File bugs on the desktop runtime into the Firefox/Web Apps component. And file bugs on the Open Web Apps (i.e. mozApps) API into the Core/Dom: Apps component.

Source Code

The source code for the runtime lives in the mozilla-central Mercurial repository in the following files and directories:

Engineers develop it in accordance with standard Mozilla development best practices, including the Coding Style Guide, the Committing Rules and Responsibilities, and Firefox's rapid release schedule.