Getb2g is a python package intended to make setting up a working B2G environment as easy as possible. It can download various configurations (e.g emulator, unagi, panda, etc.) as well as extraneaous resources such as tests and symbols. It is an alternative to building B2G from scratch which can sometimes be a large barrier to entry for those not familiar with B2G development.
Install setuptools if you don't have it already:
wget https://bitbucket.org/pypa/setuptools/raw/0.7.6/ez_setup.py -O - | python
Install pip if you don't have it already:
pip install getb2g
Note on python packages: getb2g has several dependent packages that will also be installed alongside it. Doing the above will install all those packages in your global package index. This makes it easy to get into situations where you have several libraries that depend on different versions of the same package. It is easy to get into python version hell. To avoid hell, I'd recommend using a virtual environment. See virtualenv and virtualenvwrapper (an optional tool to help manage virtual environments) for more details.
getb2g is used from the command line.
The most basic usage is:
You will be prompted for a device to configure. An educated guess will be made for extraneous resources depending on the choice you select. Run:
to see more options. All of these options are optional and are mostly just a convenience to circumvent the interactive prompt. Here are some examples of other command lines you can use:
# sets up an emulator build getb2g --prepare-emulator # sets up a panda build and only a panda build (no tests, symbols, etc) getb2g --prepare-panda --only # sets up a unagi build based off the mozilla-b2g18 branch getb2g --prepare-unagi --metadata branch=mozilla-b2g18 # set up a b2g gecko build from a specific build directory on ftp.mozilla.org getb2g --prepare-gecko --metadata build_dir='https://ftp.mozilla.org/pub/mozilla.org/b2g/tinderbox-builds/mozilla-central-ics_armv7a_gecko/1366715435/' # set up an eng variant of a inari build getb2g --prepare-inari --metadata variant=eng # provide a user name and password and never get prompted getb2g --prepare-emulator --no-prompt --metadata user=<username> --metadata password=<password>
Many of the resources require authentication because their packages contain proprietary software. If you are attempting to download one such resource, you will be prompted to enter the proper credentials. If you do not know the credentials, I apologize.
By default, your username and password will not be saved. If you want getb2g to remember your passwords, simply use the --store option. With this set, any passwords you enter during the session will be stored locally for later use. Note that passwords are not encrypted before hand, so anyone with access to your computer may be able to see them.
If you want getb2g to forget everything you previously stored, simply run 'rm ~/.getb2g/storage.db'