The Meson Build System http://mesonbuild.com/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

44 lines
1.4 KiB

---
short-description: Build targets for custom languages or corner-cases
...
# Custom build targets
While Meson tries to support as many languages and tools as possible,
there is no possible way for it to cover all corner cases. For these
cases it permits you to define custom build targets. Here is how one
would use it.
```meson
comp = find_program('custom_compiler')
infile = 'source_code.txt'
outfile = 'output.bin'
mytarget = custom_target('targetname',
output : 'output.bin',
input : 'source_code.txt',
command : [comp, '@INPUT@', '@OUTPUT@'],
install : true,
install_dir : 'subdir')
```
This would generate the binary `output.bin` and install it to
`${prefix}/subdir/output.bin`. Variable substitution works just like
it does for source generation.
## Details on compiler invocations
Meson only permits you to specify one command to run. This is by
design as writing shell pipelines into build definition files leads to
code that is very hard to maintain. If your compilation requires
multiple steps you need to write a wrapper script that does all the
necessary work. When doing this you need to be mindful of the
following issues:
* do not assume that the command is invoked in any specific directory
* a target called `target` file `outfile` defined in subdir `subdir`
must be written to `build_dir/subdir/foo.dat`
* if you need a subdirectory for temporary files, use
`build_dir/subdir/target.dir`