Packaging Droid HAL#

In this chapter, we will package the build results of building the Android HAL as RPM packages and create a local RPM repository. From there, the RPM packages can be added to a local target and used to build libhybris and the QPA plugin. They can also be used to build the rootfs.

Creating Repositories for a New Device#

If the folders rpm, hybris/droid-configs, hybris-droid-hal-version-$DEVICE do not exist yet, create them as follows (example is for Nexus 5, adjust as appropriate and push to your GitHub home):

PLATFORM SDK

cd $ANDROID_ROOT
mkdir rpm
cd rpm
git init
git submodule add https://github.com/mer-hybris/droid-hal-device dhd
# Rename 'hammerhead' and other values as appropriate
sed -e "s/@DEVICE@/hammerhead/" \
    -e "s/@VENDOR@/lge/" \
    -e "s/@DEVICE_PRETTY@/Nexus 5/" \
    -e "s/@VENDOR_PRETTY@/LG/" \
    dhd/droid-hal-@DEVICE@.spec.template > droid-hal-hammerhead.spec
# Please review droid-hal-hammerhead.spec before committing!
git add .
git commit -m "[dhd] Initial content"
# Create this repository under your GitHub home
git remote add myname https://github.com/myname/droid-hal-hammerhead.git
git push myname master
cd -

mkdir -p hybris/droid-configs
cd hybris/droid-configs
git init
git submodule add https://github.com/mer-hybris/droid-hal-configs \
    droid-configs-device
mkdir rpm
sed -e "s/@DEVICE@/hammerhead/" \
    -e "s/@VENDOR@/lge/" \
    -e "s/@DEVICE_PRETTY@/Nexus 5/" \
    -e "s/@VENDOR_PRETTY@/LG/" \
    droid-configs-device/droid-config-@DEVICE@.spec.template > \
    rpm/droid-config-hammerhead.spec
# Please review rpm/droid-config-hammerhead.spec before committing!
git add .
git commit -m "[dcd] Initial content"
# Create this repository under your GitHub home
git remote add myname https://github.com/myname/droid-config-hammerhead.git
git push myname master
cd -

rpm/dhd/helpers/add_new_device.sh
# On Nexus 5 the output of the last command is:
# Creating the following nodes:
# sparse/
# patterns/
# patterns/jolla-configuration-hammerhead.yaml
# patterns/jolla-hw-adaptation-hammerhead.yaml
cd hybris/droid-configs
git add .
git commit -m "[dcd] Patterns and compositor config"
git push myname master
cd -

mkdir -p hybris/droid-hal-version-hammerhead
cd hybris/droid-hal-version-hammerhead
git init
git submodule add https://github.com/mer-hybris/droid-hal-version
mkdir rpm
sed -e "s/@DEVICE@/hammerhead/" \
    -e "s/@VENDOR@/lge/" \
    -e "s/@DEVICE_PRETTY@/Nexus 5/" \
    -e "s/@VENDOR_PRETTY@/LG/" \
    droid-hal-version/droid-hal-version-@DEVICE@.spec.template > \
    rpm/droid-hal-version-hammerhead.spec
# Please review rpm/droid-hal-version-hammerhead.spec before committing!
git add .
git commit -m "[dvd] Initial content"
# Create this repository under your GitHub home
git remote add myname \
    https://github.com/myname/droid-hal-version-hammerhead.git
git push myname master

Now to complete you local manifest, this is how it would be done for Nexus 5. Do it for your device by renaming accordingly.

Add the next 3 entries into .repo/local_manifests/hammerhead.xml

<project path="rpm/"
         name="myname/droid-hal-hammerhead" revision="master" />
<project path="hybris/droid-configs"
         name="myname/droid-config-hammerhead" revision="master" />
<project path="hybris/droid-hal-version-hammerhead"
         name="myname/droid-hal-version-hammerhead" revision="master" />

Once all these 3 repositories get upstreamed under https://github.com/mer-hybris create PR into an appropriate branch of the file .repo/local_manifests/hammerhead.xml to the https://github.com/mer-hybris/local_manifests repository.