For Distro Packagers#
blueprint-compiler is a build tool that converts UI definitions written in Blueprint into XML files that are installed with the app and that GTK can read. So for most applications that use blueprint-compiler, it is a build dependency. It is a Python program, but like most GNOME-related projects, it uses Meson as its build system.
GObject Introspection#
Blueprint files can import GObject Introspection namespaces like this:
using Gtk 4.0;
using Adw 1;
To compile a blueprint file, .typelib
files for all of the imported
namespaces must be installed. All blueprint files must import Gtk 4.0, so
Gtk-4.0.typelib
is effectively a runtime dependency of blueprint-compiler.
blueprint-compiler also depends on pygobject, because it uses GIRepository
to determine the search path for typelib files.
So, if a package uses blueprint-compiler, its build dependencies should include the typelib files for any namespaces imported in its blueprint files. (Note that many apps also have the same typelib files as runtime dependencies, separately from blueprint).
In addition, the blueprint language server uses .gir
files to provide
documentation on hover. Some distros package these files separately from the
main package (e.g. in a -devel
package). The language server will not crash
if these files are not present, but for a good user experience you should make
sure they are installed.