mirror of https://github.com/dexoron/dcr.git synced 2026-10-21 13:38:30 +00:00

Files

Dexoron fd88e036ed feat: add cross-compilation support with --target flag

- Updated build and run commands to accept a --target option for specifying target platforms.
- Enhanced documentation to include cross-compilation usage and supported targets.
- Modified configuration to allow target-specific settings and toolchains.
- Introduced a new test command to run project tests with specified profiles and targets.
- Improved handling of target directories and output structure for different platforms.
- Added support for multiple targets in the configuration file.
- Implemented inheritance for workspace and dependencies based on target and profile.

2026-04-11 13:36:18 +08:00

2.6 KiB

Raw Blame History

Compilers & linking

Compiler backend selection

DCR picks a backend from build.compiler:

contains clang-cl -> MSVC backend
equals as or contains gas -> GAS backend (standalone assembler)
contains gcc or g++ -> GCC backend
contains clang or clang++ -> Clang backend
equals cl or contains msvc -> MSVC backend
contains nasm -> NASM backend
otherwise -> Clang backend fallback

Compilation model

Source files are found recursively in src/ based on build.language.
build.roots and build.src_disable can replace the default src/ root.
Mixed language builds use arrays, for example build.language = ["c", "asm"].
Each source is compiled to target/<target>/<profile>/obj/<relative-path>.o (.obj on MSVC, where <target> is native or target triple).
Recompile happens when source mtime is newer than object mtime.
build.exclude removes paths from source/header collection; build.include re-allows matching paths and has priority over exclude.

Default build flags

These flags are applied automatically based on profile and compiler backend.

GCC/Clang:

debug: -O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG
release: -O3 -DNDEBUG

MSVC:

debug: /Od /Zi /W4 /DDCR_DEBUG /Oy-
release: /O2 /DNDEBUG

Note: If custom cflags are set in dcr.toml, default profile flags are disabled to allow full control.

Platform hint

If build.platform is set, DCR passes it as an architecture hint:

GCC/Clang: -march=<platform>
MSVC: maps to /arch:* for known values (x86, i386, i486, i586, i686, sse2, avx, avx2)

Toolchain overrides

If [toolchain] is set, DCR uses its values to override compiler/linker tools:

cc, cxx, as override compilers for C/C++/ASM
ar overrides the archiver (used for staticlib)
ld overrides the linker (used by GCC/Clang/NASM/GAS backends)
uic, moc, rcc override Qt tools used in build.steps

Environment overrides (highest priority):

DCR_COMPILER (all languages)
DCR_CC, DCR_CXX, DCR_AS, DCR_AR, DCR_LD
DCR_DEBUG enables verbose build logging

Linking

For kind = "bin":

Object files are linked into executable artifact.
Dependency lib dirs and library names are passed to linker.
build.ldflags are appended to link command.

For kind = "staticlib":

Linux/macOS (GCC/Clang): ar rcs creates .a archive.
Windows (MSVC): lib creates .lib archive.

For kind = "sharedlib":

Linux (GCC/Clang): -shared with output .so.
macOS (Clang): -dynamiclib with output .dylib.
Windows (MSVC): /LD with output .dll.

2.6 KiB Raw Blame History