Development edition · 16 November 2026. Commands using repository paths, Make targets or sample projects require access to the Quinzee source checkout. No public installer is available. Examples use disposable local environments.
6. Build System and Dependency Cache
CMake
CMakeLists.txt: C++20, GCC 13+ check,TRIGLAV_PROFILE, output directories.cmake/triglav_compiler_options.cmake: warnings and per-profile flags;triglav_apply_project_options()andtriglav_apply_executable_options()(static libstdc++/libgcc for debug and release).cmake/triglav_dependencies.cmake: runsprepare.sh, parsesname=prefix, finds OpenSSL and Simple in CONFIG mode withNO_DEFAULT_PATH, and definestriglav::boost_headers.
Additional helpers: triglav_apply_imported_options() gives imported code
(the Simple package wrapper, Boost.JSON) the profile flags and -Wall -Wextra -Wpedantic
without the first-party baseline and -Werror. QHQ's post-build step copies
the installed SIMPLE_ASSET_DIR and src/qhq/assets/logos/ to bin/<profile>/assets/.
Parallel builds
The root Makefile adds --jobs=$(JOBS) to MAKEFLAGS, invokes CMake builds
with a + recipe prefix so the generated makefiles join Make's jobserver,
and runs CTest with --parallel. Never add a serial step; Docker builds use
-j"$(nproc)".
prepare.sh
for each manifest line (name version recipe source_identity url):
identity = hash(recipe, package, archive sha, patches[, variant, toolchain, glibc, arch])
lock .packages/locks/<name>.lock
if installed/<platform>/<name>-<ver>-<id12>/.triglav-complete: reuse
else: fetch (HTTPS archive + SHA-256, or Git + exact commit)
→ extract/checkout + patch (sources/, atomic)
→ build into staging (DESTDIR) → file hash list → identity
→ complete marker → rename into place
print name=prefix
Adding a dependency means adding a manifest line and, if it needs compiling,
a recipe function and an entry in required_file_for. Bump recipe_version
when recipe behaviour changes, so existing entries are rebuilt.
TRIGLAV_PACKAGES_DIR, TRIGLAV_DEPS_MANIFEST, and TRIGLAV_DEPS_PATCHES
redirect the script (the lifecycle test uses them).
TRIGLAV_DEPS_ALLOW_FILE_URLS=1 is for tests only.
--without-simple skips the UI package for service-only builds. CMake uses
this when TRIGLAV_BUILD_QHQ=OFF, as in the runtime Docker build.
Messaging and Functions dependencies
Service Bus adds source-built Apache Qpid Proton for AMQP framing/state and shares the verified SQLite dependency with Table Storage. The broker store remains in-process; it does not require an external broker container.
Functions uses an optional Microsoft Functions host image and locked .NET worker
and binding packages. make functions-example publishes the worker and builds
its local image; registration resolves the image to an immutable ID. Runtime
image approval and helper operation remain separate from the native cloud build.
See messaging and Functions for the source map.
Manual publication
make pdf builds the developer, administrator and internals books independently
of the native targets. make manuals-check verifies their assembly, code,
assets and destinations.
make manual-screenshots refreshes the illustrations through an isolated live
application test. The publishing guide (source checkout required)
explains their caches, output paths and verification.
make admin-manual-screenshots captures the administrative atlas against a
separate native HTTPS lab. The ordinary PDF build reads reviewed PNGs and starts
no cloud service. Its pinned Node/Chromium tools live in .packages; all three
PDF/HTML publications go into bin/manuals.