Packaging Android host utilities

From MozillaWiki
Jump to: navigation, search

Packaging Android host utilities

The host utilities are executable files that run on a *host* machine. The utilities provide services to an Android *target* device, including a web server and certificate authority. For historical reason, the host utilities include an essentially complete version of Firefox. Here's how to package new versions of the host utilities.

First, identify the target build. Generally, prefer Beta channel builds to Nightly channel builds.


For the version 60 update, host-utils was based on builds from See bug 1433279. For each of "Linux opt" and "Linux x64 opt", the build's target.tar.bz2 and were downloaded.

tar xvf target.tar.bz2
unzip "bin/*"
rm firefox/firefox*
rm -r firefox/browser
mv bin/* firefox
cp ~/<some-objdir>/build/unix/elfhack/elfhack firefox
mv firefox host-utils-60.0a1.en-US.linux-x86_64

If preparing a new archive for upload to tooltool:

tar cvf host-utils-60.0a1.en-US.linux-x86_64.tar host-utils-60.0a1.en-US.linux-x86_64
gzip host-utils-60.0a1.en-US.linux-x86_64.tar

Then upload host-utils-60.0a1.en-US.linux-x86_64.tar.gz to tooltool and update the manifest in testing/config/tooltool-manifests/linux64/hostutils.manifest.

Repeat, using "Linux opt" archives, for 32 bit.

(elfhack is required to get proper xpcshell crash reports. It is readily available in most local builds, and should perhaps be added to the common-tests zip to avoid the extra step above.)

Mac OS X

Preparing for Mac OS X is not quite so simple. Due to changes in the way that Mac OS X codesigns binaries, it's best to do this on a Mac OS X machine so that you can codesign the host utility binaries. If you don't codesign them, you will be prompted every invocation to "allow network connections". See for a discussion of the issue and the codesigning invocation used below. You will be prompted for your password (by sudo), but it's possible super user permissions are not needed.

unzip "bin/*"
open firefox-37.0a2.en-US.mac.dmg
cp -R /Volumes/FirefoxDeveloperEdition/* bin
cp -R /Volumes/FirefoxDeveloperEdition/* bin
find bin -type f -perm +111 -print | grep -v \\. | xargs sudo codesign --force --deep --sign -
mv bin host-utils-37.0a2.en-US.mac