This package is a one-stop shop for Firefox OS related tools

You need to install Vagrant, see more detail from this guide.

And you also need to install the provider for Vagrant. We will use VirtualBox as default.

• Download Vagrant's Debian package from here.
• Install Vagrant by sudo dpkg -i <PATH_TO_PKG_FILE>
• Install VirtualBox by sudo apt-get install virtualbox
• Then set up USB for VirtualBox by sudo adduser <USERNAME> vboxusers
• Re-login or restart your PC.

• Install Brew Cask.
• Install Vagrant by sudo brew cask vagrant; sudo brew cask vagrant-manager
• Install VirtualBox by sudo brew cask virtualbox

Use git clone with --recursive so the vm/ submodule are cloned too.

git clone --recursive <this repo's URL>

• Add execute permissions

$ chmod u+x launch.sh
$ chmod u+x stop.sh

• Launch VM

$ ./launch.sh

A Vagrant VM will be launched.

You should see something like this:

• Stop the VM

$ ./stop.sh

• Reset the VM to factory default

$ ./reset_vm.sh

• Run GIJ (Gaia integration test in JavaScript) directly. This is very useful in automation.

$ ./launch.sh gij

• Run GIJ on specific app

$ export APP=video; ./launch.sh gij # The `export` is important, don't miss it

#Troubleshooting

• To run launch.sh in jenkins, use xvfb-run.

#Supported Platforms

• Linux
• OS X
• (We will support windows if enought people ask for it)
• Flashable devices: Aries (Sony Z3C), Flame