NOTE: The extension is no longer going to be supported post completion of the Web Apps Integration to Desktop feature. See that feature under QA to see up to date testing on that Firefox web apps feature. This wiki exists for historical purposes of past testing on the extension.
- 1 Owners
- 2 Quick Start Guide
- 3 Testing Initiative
- 4 Native Apps and Extension Builds
- 5 Important Documents and Links
|QA Lead:||Jason Smith|
|Lead Developer:||Mike Hanson|
Quick Start Guide
Here is a quick start guide to help you dive right in to Open Web Apps:
- Download and install the extension - Latest built can be found here
- Install apps - Sample apps can be found on the App Directory or Marketplace
- View the Dashboard - Apps can be found by clicking the 'Apps' button at the bottom right of your browser or by going here
Once you have apps installed, you can launch them by clicking on them in the Dashboard. You can re-arrange the app icons and you can delete them from the Dashboard as well. You can also go to 'about:apps' (type this without the quotes in the URL bar) and launch apps there, view the manifest or delete apps.
The following list summarizes the major areas of testing for OWA extension:
- Extension Installation Processes (e.g. Install, Uninstall, Update)
- MozApps API
- Apps Lifecycle (e.g. Installation, Launching, Using, Deleting)
- App Sync
- Other Areas
Future areas of concern include the following:
- Web Activities/Intents
Testing Requirements and Development Processes
The following list summarizes major testing requirements and development processes for the OWA Extension:
- Determine extension requirements and specifications
- Create manual test cases for basic sanity coverage
- Developing automated test cases for manual test cases
- Exploratory testing of each major part of OWA Extension
- Exploratory testing of using the apps on the web and native
- Creation of complex manual scenario testing
- Requirements are highly volatile, so manual and automated test cases need to be constantly kept up to date.
- Extension will eventually be built into browser, so some test cases may not be needed anymore in the long run
Bugs are reported under the "Web Apps" product in the "Extension" component. Below summarizes important links for viewing and reporting extension bugs.
Note: See How to Write a Proper Bug on how to report bugs.
Note: A tracking bug was used for tracking the alpha release of the extension in the past.
Build Verification Process
The following summarizes the build verification process for the extension:
- Install the latest build of the OWA extension
- Verify any bugs that have been resolved on the latest extension build
- Run automation tests to make sure no regressions have occurred
- Run manual test cases and exploratory testing to capture possible regressions
- File new bugs as necessary
- Update test case document by adding and modifying existing test cases and removing obsolete test cases
The automation efforts will revolve around automating the manual test cases using mozmill. Since currently there is not much to work with, a basic skeleton framework is being looked into that can hopefully hold common API's that will be used when automating the test cases.
A demo test run was created with MozMill that installs an app, runs the app, closes the app and then deletes it. The patch for the demo test can be found here. Henrik Skupin is going to write a blog post about OWA automation and will include a demo that runs this script.
An already existing nodejs server was modified to host test apps that we can use for load and smoke testing. To use the test server, please follow these steps (in linux):
- git clone git://github.com/mozilla/openwebapps.git
- cd openwebapps
- Type: 'git submodule init' and then 'git submodule update'
- Make sure to have node installed - If not, you can get it from here. You can also follow one of the methods here.
- cd site/tests/
- Type: 'node run.js' - All necessary servers will start
- Launch the URL after 'Testing server started, to run tests go to:' and replace index.html with appstore.html
- A webpage will be shown that contains all the test apps
How It Works:
It's just a nodejs server that creates a separate server for each app that we have and hosts the necessary files within each server. The directory where the apps are stored is in site/tests/apps and each app has a folder within this directory.If you would like to add apps, all you have to do is add a folder within the apps directory and place the necessary files within that folder (please look at repo under site/tests/apps/ for examples). Please note the following:
- The manifest file must be called: manifest.webapp (this should be changed within the code to be more dynamic)
- If there is a problem with the page formatting, it's most likely because the icon pic used for the app is not compatible. The icon pic must be 128x128px in order to show up properly in the test server and in the Dashboard. You can use software such as gimp to adjust the pic size.
Native Apps and Extension Builds
Native App Generation
Native app generation just means allowing the user to install apps natively on their machine. This is equivalent to installing a program or application. If you would like to check it out, please follow these steps (advanced) or simply install one of the extensions from here:
- Install the addon-sdk (from github as the release version will not work) - https://github.com/mozilla/addon-sdk
- Download the oauthorizer package into the packages folder of the addon-sdk - https://github.com/mozilla/oauthorizer
- Clone the openwebapps project - https://github.com/mozilla/openwebapps
- In a terminal, cd into the addon-sdk folder and type: bin\activate (windows) or source bin/activate (linux)
- cd into openwebapps/addons/jetpack
- Type: cfx run
The developer builds are created whenever a commit is made to the openwebapps github repo. The format is openwebapps-<commit id>-<date>.xpi. For automation, openwebapps.xpi within the 'latest' folder is used to avoid making changes to the addon.ini file for every test run. To build the extension yourself from the github repository, please do the following:
- git clone http://github.com/mozilla/openwebapps
- cd openwebapps
- make xpi (this will build the xpi file and place it in your current directory)
You can drag the xpi file to your Firefox window to install it. You can also host the file on the web and the user would just click on the xpi file to install it to their Firefox.