Gaia is Mozilla's Phone UX for the Boot to Gecko (B2G) project.
Boot to Gecko aims to create a complete, standalone operating system for the open web.
You can read more about B2G here:
follow us on twitter: @Boot2Gecko
join the Gaia mailing list:
http://groups.google.com/group/mozilla.dev.gaia
and talk to us on IRC:
#gaia on irc.mozilla.org
See INSTALL file in B2G repository for instructions on building and running B2G. To try out Gaia on desktop, see
https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS https://wiki.mozilla.org/Gaia/Hacking
Installing on different devices resolution
Currently supported screens
- qHD: ~540×960, device pixel ratio = 1.6875
- WVGA: ~480×800, device pixel ratio = 1.5
How to:
You need to set HIDPI=1
when using any make
command
Examples
HIDPI=1 make reset-gaia
HIDPI=1 make install-gaia
HIDPI=1 BUILD_APP_NAME=contacts make install-gaia
Tests
Unit Tests
Unit tests for an app go in apps/<APP>/test/unit/
.
To run all the unit tests with B2G Desktop:
-
Run
DEBUG=1 make
-
Run
make test-agent-server &
-
Run B2G Desktop and open the Test Agent app
-
Run
make test-agent-test
or
make test-agent-test APP=<APP>
to run unit tests for a specific app
More importantly, you can use test-agent-server to watch the files on the filesystem and execute relevant tests when they change:
- Run
DEBUG=1 make
- Run
make test-agent-server &
- Run B2G Desktop and open the Test Agent app
- Edit files and when you save them, glance at the console with test-agent-server running
Note: If you add new files, you will need to restart test-agent-server.
For more details on writing tests, see: https://developer.mozilla.org/en/Mozilla/Boot_to_Gecko/Gaia_Unit_Tests
Integration Tests
Integration tests for an app are located in
apps/<APP>/test/integration/
.
Prerequisites:
- adb
- FirefoxOS Device / Emulator / B2G Desktop
To run integration tests:
-
In your gaia/ directory, run
make
to build the profile -
Run B2G Desktop
or forward port 2828 from your device / emulator using
adb forward tcp:2828 tcp:2828
-
Run
make test-integration
from the gaia/ directoryor
make test-integration APP=<APP>
to run unit tests for a specified appor
make test-integration TESTS=<PATH/TO/TESTFILE.js>
to run unit tests in a specific fileor
make test-integration REPORTER=<REPORTER>
to run integration tests with the specified reporter, for exampleXUnit
or
make test-integration TESTVARS=<PATH/TO/TESTVARS.json>
to run tests with variables in the testvars file (this defaults to testvars.json)
Note: If you're using a FirefoxOS Device, it must have been flashed
with a build with marionette enabled. If it doesn't have marionette
enabled, then running make test-integration
will time out.
The testvars file is a JSON file that maps app names to objects holding key/values as required by that app's integration tests. See that app's integration test code and/or README for which key/values are required.