dexoron/dcr
1
1
Fork 0
mirror of https://github.com/dexoron/dcr.git synced 2026-10-21 18:09:40 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
9d8dcda366a3a54bdfa6601a89ee2ec59f5f5888
dcr/docs/dependencies-and-build/compilers-and-linking.md
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.