dexoron/dcr
1
1
Fork 0
mirror of https://github.com/dexoron/dcr.git synced 2026-10-21 17:19:37 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
9a24a80d59e7bd7109d0538edfd1d6bddbddbbdc
dcr/docs/commands/dcr-build.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.3 KiB
Raw Blame History

dcr build

Builds the project in debug or release profile.

Usage

dcr build
dcr build --debug
dcr build --release
dcr build --target linux --release
dcr build --release --force
dcr build --debug --clean

What build does

  1. Checks that dcr.toml exists and is valid.
  2. Reads build settings from [build].
  3. Resolves path dependencies from [dependencies].
  4. Creates required output directories.
  5. Recursively compiles sources from src/.
  6. Links final artifact (binary or library).

Config values used

  • package.name
  • build.compiler
  • build.language
  • build.standard
  • build.kind
  • build.target
  • build.platform
  • build.cflags
  • build.ldflags
  • build.debug / build.release
  • build.exclude
  • build.include
  • build.pkg_config
  • build.steps
  • build.post_steps
  • build.generated
  • build.expect
  • build.clean

Source selection

  • language = "c" -> *.c
  • language = "c++" | "cpp" | "cxx" -> *.cpp, *.cxx, *.cc
  • language = "asm" -> *.s, *.S, *.asm
  • Mixed languages are supported with arrays, for example language = ["c", "asm"].
  • By default sources are searched in src/; use build.roots and build.src_disable to override.

Notes

  • Profile flag (--debug / --release) can appear in any argument position (duplicates are rejected).
  • Unknown profile flags return an error.
  • --target <triple> builds for specified target (short names: linux, macos, windows).
  • If no --target, builds for build.targets or native.
  • Incremental rebuild checks source/object mtime and tracked header dependencies.
  • --force skips build cache checks and recompiles.
  • --clean removes target/<profile> and build.clean paths before building.
  • Default GCC/Clang profile flags: debug -> -O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG, release -> -O3 -DNDEBUG.
  • For language = "asm" with compiler = "as"/"gas", use .s files (no preprocessing). For .S, use gcc or clang.
  • In workspace root, dcr build builds all members in dependency order.
  • build.exclude removes paths from source/header collection; build.include re-allows matching paths and has priority over exclude.
  • build.steps run before compilation; build.post_steps run after linking.
  • build.generated is cleaned when build.steps need to rerun; build.expect is verified after post-steps.