To set up your local fwupd development environment, from the top level of the checkout run the fwupbuild build tool:
./fwupbuild init builddirWhere builddir represents a user-specified directory that will contain
the fwupd build directory. All code and test installs will be built within that
directory.
This will also create pre-commit hooks to fixup many code style issues before your code is submitted.
On some Linux distributions this will install all build dependencies needed to compile fwupd as well.
A virtualenv will be created in builddir
and running fwupd without affecting the local system installation.
To enter this virtualenv run:
source builddir/bin/activateTo build fwupd in the venv run:
fwupbuild -C builddir buildIf the -C builddir argument is omitted, fwupbuild will find the most recently
initiated directory.
Wrappers are configured while in the venv to run fwupdtool, fwupd, and
fwupdmgr using the virtualenv directory structure. To leave the virtualenv
run:
deactivateDeveloper documentation including API documentation and a plugin tutorial is available on https://fwupd.github.io/.
The coding style to respect in this project is very similar to most GLib projects. In particular, the following rules are largely adapted from the PackageKit Coding Style.
-
8-space tabs for indentation
-
Prefer lines of less than <= 100 columns
-
No spaces between function name and braces (both calls and macro declarations)
-
If function signature/call fits in a single line, do not break it into multiple lines
-
Prefer descriptive names over abbreviations (unless well-known) and shortening of names. e.g
devicenotdev -
Single statements inside if/else should not be enclosed by '{}'
-
Use comments to explain why something is being done, but also avoid over-documenting the obvious. Here is an example of useless comment:
// Fetch the document fetch_the_document();
-
Comments should not start with a capital letter or end with a full stop and should be C-style, not C++-style, e.g.
/* this */not// this -
Each object should go in a separate .c file and be named according to the class
-
Use g_autoptr() and g_autofree whenever possible, and avoid
goto outerror handling -
Failing methods should return FALSE with a suitable
GErrorset -
Trailing whitespace is forbidden
-
Pointers should be checked for NULL explicitly, e.g.
foo != NULLnot!foo -
Use the correct debug level:
g_debug()-- low level plugin and daemon development, typically only useful to programmersg_info()-- generally useful messages, typically shown when using--verboseg_message()-- important messages, typically shown in service outputg_warning()-- warning messages, typically shown in service outputg_critical()-- critical messages, typically shown before the daemon aborts
NOTE: Do not use g_error() -- it's not appropriate to abort the daemon on error.
clang-format can be used in order to get automated formatting. It is invoked
as part of the pre-commit hooks executed on git commit. Using pre-commit is
the recommended way of checking coding style. Please refer to the
clang-format documentation
for other invocations.