dart build

Use the dart build command to build a Dart application. This command automatically runs build hooks from your project and its dependencies to compile or download code assets and bundle them with your application.

The dart build cli command builds a Dart application with a command-line interface (CLI) including any code assets.

The resulting app bundle is structured as follows:

bundle/
  bin/
    <executable>
  lib/
    <dynamic libraries>

The following options can be used for the dart build cli command.

Use the -h or --help option to get help for the cli subcommand.

$ dart build cli --help

$ dart build cli -h

Use -o or --output to specify where dart build saves the generated files. The output is placed in a bundle/ directory within the given path, which can be absolute or relative. If omitted, the default path is build/cli/_/.

$ dart build cli --output=<path>

$ dart build cli -o=<path>

For example, to set the output directory to ./my_custom_output:

$ dart build cli --output=./my_custom_output

Use the -t or --target option to specify the main entry-point file of the command-line application.

This must be a Dart file in the bin/ directory. If the option is omitted and there is a single Dart file in bin/, then that is used instead.

$ dart build cli --target=<path>

$ dart build cli -t=<path>

For example, to set the entrypoint to the bin/my_command.dart file:

$ dart build cli --target=bin/my_command.dart

Use the --verbosity option to set the verbosity level of the compilation. The level can be error, warning, info, or all.

$ dart build cli --verbosity=<level>

For example, to show only error messages:

$ dart build cli --verbosity=error