KICKSTARING GAIA
THE BASICS
Running the Gaia codebase
- Flash your phone with an updated Gaia build.
- Launch your Gaia inside a B2G Desktop build.
- Run your Gaia inside the App Manager/Firefox Simulator.
- Launch Gaia inside Desktop Firefox
Understanding the codebase
apps/
build/
dev_apps/
keyboard/
locales/
shared/
tools/
apps/
- index.html: the central file for each app
- manifest.webapp: the manifest file defines the app
- locales: localisation strings for that app
- test: unit and integration tests particular to that app
- js, style: scripts and styles for that app
- resources: images, sounds and other assets
Gaia Coding Style
- Declare with <!DOCTYPE HTML>
- "use strict"
- Two spaces for indentation, no tabs
- Seperate multiword filenames with underscore
- Single quotes for strings
Lets get started!
Running Gaia in Desktop Firefox
- First, make a fork of the main Gaia repo on Github.
- Next, clone your fork locally
git clone https://github.com/your-username/gaia.git3. Add the upstream
cd gaia
git remote add upstream https://github.com/mozilla-b2g/gaia4. Build the DEBUG Profile
DEBUG=1 make/path_to_firefox -profile ../gaia/profile-debug5. Run it!
Making changes to the code
-
When making changes to Gaia, you should first Grab the latest from master:
cd path/to/gaia
git checkout master
git pull upstream master
2. Next, check out a new branch to create your fixes on:
git checkout -b my-code-fix[GOOD FIRST BUGS]
I blogged on the same
@dolftax
