Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

build

This field defines a custom build step for the module.

It is used for code generation or pre-processing steps where a module needs to produce source files or other artifacts before normal compilation. The build commands have access to the module’s environment variables.

fields

  • cmd: Required. A list of shell commands. They are joined with && to form a single ninja build command.
  • out: Optional. A list of output files produced by the custom build.
  • gcc_deps: Optional. A string specifying a file for gcc-style dependency tracking.

Example:

modules:
  - name: generated_code
    is_build_dep: true
    depends:
      - config_module
    build:
      cmd:
        - echo ${VARIABLE} > build/${builder}/generated.c
      out:
        - build/${builder}/generated.c
    sources:
      - build/${builder}/generated.c