dub-build(1)

1DUB-BUILD(1)               The D Language Foundation              DUB-BUILD(1)
2
3
4

NAME

6       dub - Package and build management system for D
7

SYNOPSIS

9       dub build [<package>[@<version-spec>]] OPTIONS...
10

DESCRIPTION

12       Builds  a  package (uses the main package in the current working direc‐
13       tory by default)
14

OPTIONS

16       --rdmd Use rdmd instead of directly invoking the compiler
17
18       -f,    Forces a recompilation even if the target is up to date
19
20       -y,    Automatic yes to prompts. Assume "yes" as answer to all interac‐
21              tive prompts.
22
23       -n,    Don't enter interactive mode.
24
25       -b,    Specifies  the  type  of build to perform. Note that setting the
26              DFLAGS environment variable will override the  build  type  with
27              custom flags.  Possible names:
28                debug   (default),  plain,  release,  release-debug,  release-
29              nobounds,  unittest,  profile,  profile-gc,  docs,  ddox,   cov,
30              unittest-cov, syntax and custom types
31
32       -c,    Builds  the  specified  configuration. Configurations can be de‐
33              fined in dub.json
34
35       --override-config=VALUE
36              Uses the specified configuration for a certain  dependency.  Can
37              be  specified multiple times.  Format: --override-config=<depen‐
38              dency>/<config>
39
40       --compiler=VALUE
41              Specifies the compiler binary to use (can be a path).  Arbitrary
42              pre-  and suffixes to the identifiers below are recognized (e.g.
43              ldc2 or dmd-2.063) and matched to the proper compiler type:
44                dmd, gdc, ldc, gdmd, ldmd
45
46       -a,    Force a different architecture (e.g. x86 or x86_64)
47
48       -d,    Define the specified debug version identifier  when  building  -
49              can be used multiple times
50
51       --nodeps
52              Do not resolve missing dependencies before building
53
54       --build-mode=VALUE
55              Specifies  the  way  the  compiler and linker are invoked. Valid
56              values:
57                separate (default), allAtOnce, singleFile
58
59       --single
60              Treats the package name as a filename. The file must  contain  a
61              package recipe comment.
62
63       --force-remove
64              Deprecated option that does nothing.
65
66       --filter-versions
67              [Experimental]  Filter  version  identifiers  and  debug version
68              identifiers to improve build cache efficiency.
69
70       --combined
71              Tries to build the whole project in a single compiler run.
72
73       --print-builds
74              Prints the list of available build types
75
76       --print-configs
77              Prints the list of available configurations
78
79       --print-platform
80              Prints the identifiers for the current build  platform  as  used
81              for the build fields in dub.json
82
83       --parallel
84              Runs multiple compiler instances in parallel, if possible.
85

FILES

87       dub.sdl, dub.json
88

AUTHOR

90       Copyright (c) 1999-2022 by The D Language Foundation
91

ONLINE DOCUMENTATION

93       ⟨http://code.dlang.org/docs/commandline⟩http://code.dlang.org/docs/commandline
94