The most common use case for packaging is to have the output of a GNU make
setup be wrapped into a neat .rpm file. But we will take something more simple
for this example - we only want to install a single configuration file.
You can view the finished project at github.
So, first we need to decide what we want to install and where to. In our case,
the file is a configuration file that tells journald to
save the system logs across reboots. It shall end up in
/etc/system/journald.conf.d/journald-porting.conf.
We now put the source files of the package into sparse/*.
Now we need to tell the packaging system some metadata about our project.
marina-porter-tools.spec
Name: marina-porter-tools
Summary: Extra debugging tools and configs for porting
Version: 1
Release: 1
The interesting part is the %install section:
%install
mkdir -p %{buildroot}/
cp -r sparse/* %{buildroot}/
This tells the packaging system to install all files from sparse to the RPM
temporary buildroot, creating the final filesystem hierarchy already.
Now we need to tell rpm explicitly which files are contained inside the finished package. We could do it the easy way:
%files
/etc/systemd/journald.conf.d/journald-porting.conf
But we can tell the package manager more about the installed files. In our case, we want the user to be able to overwrite the config files we installed, so we supply more metadata:
%files
%defattr(-,root,root,-)
%config /etc/systemd/journald.conf.d/journald-porting.conf
And that’s it. Assuming you cloned the example repo to
hybris/mw/marina-porter-tools, you can now use the droid-hal-device helper
script to build the finished .rpm:
./rpm/dhd/helpers/build_packages.sh \
--build hybris/mw/marina-porter-tools \
--spec rpm/marina-porter-tools.spec
Copy the generated .rpm file from droid-local-repo/$DEVICE to your phone and
install it via pkcon - or add the package to your device’s build requirements
to ease early porting.
Further references
- Maximum RPM: Taking the RPM Package Manager to the Limit: Creating the Spec File and Directives For the %files list
- Fedora docs: Creating a Basic Spec file