To build Fuchsia, you need to be able to run the
fx command in your terminal.
Set build configuration
To set your build configuration for Fuchsia, run the following command:
fx set <var>product</var>.<var>board</var>
fx set command takes PRODUCT and BOARD arguments,
which define the
product and board
configuration of your build. This configuration informs the build system what
packages to build for your Fuchsia device.
For the core set of Fuchsia features, the build configuration is
fx set core.x64
core is a product with a minimal feature set, which includes
common network capabilities, and
x64 refers to the x64 architecture.
For a Fuchsia emulator with the core set of Fuchsia features, the build configuration is
fx set core.qemu-x64
See Configure a build for more options.
Speed up the build
To reduce the time it takes to build Fuchsia, you can do any of the following:
Speed up the build with Goma
Goma is a distributed compiler service for open source projects such as Chrome, Android and Fuchsia. If you have access to Goma, run the following command to enable a Goma client on your machine:
Speed up the build with ccache
If you do not have access to Goma, but want to accelerate the Fuchsia build
ccache to cache
artifacts from previous builds.
ccache on Linux, install the following package:
sudo apt-get install ccache
For macOS, see Using CCache on Mac for installation instructions.
ccache is enabled automatically if your
CCACHE_DIR environment variable
refers to an existing directory.
To override the default behavior, pass the following flags to
Force use of ccache even if other accelerators are available:
fx set core.x64 --ccache
Disable use of ccache:
fx set core.x64 --no-ccache
To build Fuchsia, run the following command:
fx build command executes the build to transform source code into packages
and other build artifacts.
If you modify source code, re-run the
fx build command to perform an
incremental build, or run the
fx -i build command to start a watcher, which
automatically builds whenever you update source code.
See Execute a build for more information.