Updating your code
If this isn't your very first time building B2G, you might want to pull the latest code before you start to build. To do that, you should update both the B2G tools and the dependencies, using the following two commands:
git pull ./repo sync
You can update a specific make target's repository by specifying its name:
./repo sync gaia
The repo command has other options available that might be interesting;
repo help will give you a lot of information.
Note: Before building, you may want to set up a
.userconfig file to customize the build. See Customization with the .userconfig file for details.
To build Boot to Gecko, simply use the
cd B2G ./build.sh
Time for another coffee break, or possibly a nap (especially if this is your first build).
Building specific modules
If you want to build just a particular module, such as Gecko, you can specify it by name:
To get a list of the modules you can build, you can do:
Setting the number of processor cores to use
By default, the B2G build scripts use the number of cores your system has plus two as the number of parallel tasks to run. You can change this by specifying the
-j parameter when running
build.sh. This can be handy if you're using your system for other things while building in the background and need to reduce CPU load a bit. It's also handy when you're having build problems, as it can make reading error output from the build process easier if you have just one task going at a time!
For example, to build using just two parallel tasks:
The most common use case for this, however, is to prevent builds from running in parallel at all. This makes the output of the process much easier to read, making it easier to sort out build problems. To do this:
If you get build errors while the build system is running tests
Sometimes (especially after build tool or operating system updates) you'll get weird errors like this when the build system runs its post-build tests:
Generating permissions.sqlite... test -d profile || mkdir -p profile run-js-command permissions WARNING: permission unknown:offline-app WARNING: permission unknown:indexedDB-unlimited build/permissions.js:122: NS_ERROR_UNEXPECTED: Component returned failure code: 0x8000ffff (NS_ERROR_UNEXPECTED) [nsIPermissionManager.add] make: *** [permissions] Error 3 make: *** [gaia/profile.tar.gz] Error 2
In this situation, try deleting the
gaia/xulrunner-sdk directory and re-pulling the code:
rm -r gaia/xulrunner-sdk
This deletes the downloaded, precompiled copy of XULRunner that the build system retrieves automatically; on your next build, a new copy of XULRunner will be automatically retrieved.
After building, your next step depends on whether you built Boot to Gecko for the emulator or for a real mobile device; see the following articles for details: