mirror of https://git.proxmox.com/git/fwupd synced 2025-05-25 21:05:42 +00:00

History

Crag Wang 1be055fb1e trivial: check-license: exclude files from build directory earlier		2021-10-29 12:21:55 +08:00
..
out-of-tree-link	trivial: reformat the whole tree to match new format	2021-08-24 11:18:40 -05:00
qt5-thread-test	trivial: Fix a compile failure with new GLib versions	2021-03-21 20:18:34 +00:00
abidiff.suppr	Allow the daemon to request interactive action from the end user	2021-07-14 17:03:50 +01:00
arch.sh	trivial: Merge python steps from contrib/setup into helper script	2021-09-17 10:59:35 -05:00
build_freebsd_package.sh	build_freebsd_package.sh: Build package with generated pkg-plist	2021-08-18 08:39:11 -05:00
build_windows.sh	Add support for devices supporting the Logitech bulk controller protocol	2021-08-29 20:33:16 +01:00
centos.sh	trivial: move clone firmware shell code into common script	2021-08-18 07:58:17 -05:00
check_missing_translations.sh	Catch missing translation files in POTFILES.in	2018-06-29 06:43:06 +01:00
check-abi	Allow building the documentation with gi-docgen and gtk-doc	2021-06-09 22:21:53 +01:00
check-deprecated.sh	trivial: Add pre-commit hooks for style	2021-04-09 16:02:20 +01:00
check-headers.py	trivial: ci: Check for inclusion of private headers during pre-commit	2021-06-16 08:32:29 -05:00
check-license.py	trivial: check-license: exclude files from build directory earlier	2021-10-29 12:21:55 +08:00
check-null-false-returns.py	Make the null-false-returns script also process return type	2021-01-14 14:22:15 +00:00
check-quirks.py	trivial: Make the quirk style more consistent	2021-08-23 18:10:12 +01:00
debian_s390x.sh	trivial: fix various shellcheck warnings	2021-08-18 07:58:17 -05:00
debian.sh	Remove PLUGINBUILDDIR and use G_TEST_SRCDIR and G_TEST_BUILDDIR instead	2021-10-21 18:36:22 +01:00
dependencies.xml	trivial: setup: drop the special case for python3-venv	2021-09-17 10:59:35 -05:00
Dockerfile-arch.in	trivial: fixup Dockerfile for arch	2021-06-08 20:17:35 -05:00
Dockerfile-debian.in	trivial: Github actions: Split up container creation	2020-11-18 06:47:57 -06:00
Dockerfile-fedora.in	trivial: Move the Fedora CI to a supported release	2021-04-28 10:07:04 +01:00
Dockerfile-snap.in	trivial: snap: pull from edge channel to build	2019-02-25 21:27:18 -06:00
Dockerfile-ubuntu.in	trivial: Github actions: Split up container creation	2020-11-18 06:47:57 -06:00
Dockerfile-void.in	trivial: fix void docker container creation	2021-07-28 21:42:54 -05:00
fedora.sh	trivial: Merge python steps from contrib/setup into helper script	2021-09-17 10:59:35 -05:00
flatpak.py	Rename the development branch from master to main	2021-09-24 14:20:24 -05:00
fwupd_setup_helpers.py	trivial: Merge python steps from contrib/setup into helper script	2021-09-17 10:59:35 -05:00
generate_debian.py	trivial: reformat all python code with black	2021-04-08 10:43:29 -05:00
generate_dependencies.py	trivial: Merge python steps from contrib/setup into helper script	2021-09-17 10:59:35 -05:00
generate_docker.py	trivial: Merge python steps from contrib/setup into helper script	2021-09-17 10:59:35 -05:00
generate_news.py	trivial: don't use built-in types	2021-08-18 07:58:17 -05:00
get_test_firmware.sh	Remove PLUGINBUILDDIR and use G_TEST_SRCDIR and G_TEST_BUILDDIR instead	2021-10-21 18:36:22 +01:00
oss-fuzz.py	Move the fuzzing files into the plugin directories	2021-10-22 15:24:05 +01:00
README.md	trivial: Merge python steps from contrib/setup into helper script	2021-09-17 10:59:35 -05:00
s390x_cross.txt	Introduce an s390x cross compile target to CI	2017-09-08 09:24:54 +01:00
snap.sh	trivial: fix various shellcheck warnings	2021-08-18 07:58:17 -05:00
snapcraft-wrapper	trivial: snap: pull from edge channel to build	2019-02-25 21:27:18 -06:00
ubuntu.sh	trivial: Merge python steps from contrib/setup into helper script	2021-09-17 10:59:35 -05:00
void.sh	trivial: Merge python steps from contrib/setup into helper script	2021-09-17 10:59:35 -05:00

README.md

Continuous Integration

By using CI, builds are exercised across a variety of environments attempting to maximize code coverage. For every commit or pull request 6 builds are performed:

Fedora (x86_64)

A fully packaged RPM build with all plugins enabled
Compiled under gcc with AddressSanitizer
Tests with -Werror enabled
Tests with the built in local test suite for all plugins.
All packages are installed
An installed testing run with the "test" plugin and pulling from LVFS.
With modem manager disabled

Debian testing (x86_64)

A fully packaged DEB build with all plugins enabled
Compiled under gcc
Tests with -Werror enabled
Tests with the built in local test suite for all plugins.
All packages are installed
An installed testing run with the "test" plugin and pulling from LVFS.
All packages are removed

Debian testing (i386)

A fully packaged DEB build with all plugins enabled
Compiled under gcc
Tests with -Werror enabled
Tests with the built in local test suite for all plugins.
All packages are installed
An installed testing run with the "test" plugin and pulling from LVFS.
All packages are removed

Ubuntu devel release (x86_64)

A fully packaged DEB build with all plugins enabled
Compiled under clang
Tests without -Werror enabled
Tests with the built in local test suite for all plugins.
All packages are installed
An installed testing run with the "test" plugin and pulling from LVFS.
All packages are removed

Debian testing (cross compile s390x)

Not packaged
Tests for missing translation files
No redfish support
Compiled under gcc
Tests with -Werror enabled
Runs local test suite using qemu-user
Modem manager disabled

Arch Linux (x86_64)

A fully packaged pkg build with all plugins enabled
Compiled under gcc
Tests with -Werror enabled
Compile with the deprecated USB plugin enabled
Tests with the built in local test suite for all plugins.
All packages are installed

Flatpak

A flatpak bundle with all plugins enabled
Compiled under gcc with the org.gnome.Sdk/x86_64/3.28 runtime
Builds without the daemon, so only fwupdtool is available
No GPG, PKCS-7, GObjectIntrospection, systemd or ConsoleKit support
No tests

Adding a new target

Dockerfiles are generated dynamically by the python script generate_dockerfile.py. The python script will recognize the environment variable OS to determine what target to generate a Dockerfile for.

dependencies.xml

Initially the python script will read in dependencies.xml to generate a dependency list for that target. The XML is organized by a top level element representing the dependencies needed for building fwupd.

The child elements represent individual dependencies for all distributions.

This element has an attribute id that represents the most common package name used by distributions
This element has an attribute type that represents if the package is needed at build time or runtime.

Each dependency then has a mapping to individual distributions (distro).

This element has an attribute id that represents the distribution.

Each distribution will have package elements and control elements. Package elements represent the name of the package needed for the distribution.

An optional attribute variant represents one deviation of that distribution. For example building a specific architecture or with a different compiler.
If the package element is empty the id of the dependency element will be used.
Control elements represent specific requirements associated to a dependency. They will contain elements with individual details.
version elements represent a minimum version to be installed
inclusive elements represent an inclusive list of architectures to be installed on
exclusive elements represent an exclusive list of architectures to not be installed on

For convenience there is also a helper script ./contrib/ci/fwupd_setup_helpers.p install-dependencies that parses dependencies.xml.

Dockerfile.in

The Dockerfile.in file will be used as a template to build the container. No hardcoded dependencies should be put in this file. They should be stored in dependencies.xml.