dexoron/dcr
1
1
Fork 0
mirror of https://github.com/dexoron/dcr.git synced 2026-10-21 13:18:29 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
5f0dca4bb3c38bda1bd9c9051566741d7bdb7ba1
dcr/docs/commands/dcr-build.md
Dexoron 5f0dca4bb3 Added: 
- `dcr gen` command for IDE integration and build tool support
    - `dcr gen project-info`: Output project metadata as JSON
    - `dcr gen compile-commands`: Generate `compile_commands.json` for clangd and clang-tidy
    - `dcr gen vscode`: Generate VS Code `.vscode/` integration (launch.json, tasks.json, settings.json)
    - `dcr gen clion`: Generate JetBrains CLion `.idea/` integration (run configurations, build targets)
- Full workspace support for all `gen` subcommands
2026-03-19 00:02:04 +08:00

2.0 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 --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

  • The profile is selected from the first argument only.
  • Unknown profile flags return an error.
  • Incremental rebuild is based on source/object mtime comparison.
  • --force skips build cache checks and recompiles.
  • --clean removes target/<profile> and build.clean paths before building.
  • 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.