Skip to content

development.md

Latest commit

 

History

History
162 lines (107 loc) · 3.09 KB

development.md

File metadata and controls

162 lines (107 loc) · 3.09 KB
Raw

Development

This document covers local build, Docker, and RPM packaging commands for DNF UI.

Native build

Fedora build dependencies are listed in fedora-native-dependencies.txt.

Install them with:

./utils/install_fedora_dependencies.sh

Meson handles the real build and install logic. The Makefile is a thin task runner for the common developer commands.

Build and run:

make && ./dnfui

Build final and run:

FINAL=y make && ./dnfui

Run the Meson setup directly:

meson setup build/debug --prefix /usr --libexecdir libexec
meson compile -C build/debug
./build/debug/src/dnfui

Native transaction testing

For native Polkit testing from the source tree, build the app and run it as a regular desktop user:

make
./dnfui

When you apply a transaction, the desktop Polkit prompt should appear.

NOTE:

  • Choose a non critical installed package for native apply tests
  • Package changes go through DNF5 dnf5daemon

Docker

Docker is the default container runtime. The container targets also support Podman by setting CONTAINER_RUNTIME=podman. The target names still say Docker though.

Running the application in a container is useful for testing and developing without affecting the host system.

Build the development image:

make dockersetup

Build the development image with Podman:

CONTAINER_RUNTIME=podman make dockersetup

Run the application in a container:

make dockerrun

Run the application in Docker with networking disabled:

make dockerrunoffline

Run the application in Docker with networking disabled and an empty repo cache:

make dockerruncoldoffline

RPM packaging

Fedora RPM packaging is included for this application.

Build a source RPM from the current tracked working tree:

make srpm

Build binary and source RPMs locally:

make rpm

Build a source RPM in Docker:

make dockersrpm

Build binary and source RPMs in Docker:

make dockerrpm

Artifacts are written under ./rpmbuild/.

Notes:

  • The RPM package is built from dnf-ui.spec
  • make srpm includes files tracked by Git in the generated source tarball
  • The Docker RPM targets use the existing Fedora development image and write artifacts into the same ./rpmbuild/ tree

Run rpmlint on the source RPM and binary RPMs:

rpmlint dnf-ui-latest.src.rpm rpmbuild/RPMS/*/*.rpm

To check that the package builds without depending on files or packages from your own system, rebuild the generated source RPM in an isolated Fedora build environment with mock:

mock -r fedora-rawhide-x86_64 --rebuild dnf-ui-latest.src.rpm

Use a different -r value if you want to build for another Fedora release or architecture.

Docker GDB

Run the app under GDB in the development container:

make dockergdb

Stop the GDB container if it is still running:

make dockergdbstop

The Docker GDB target starts a system bus in the container and checks that dnf5daemon can be activated before launching GDB.