这篇文档将引导您在主机上配置并构建 Fuchsia。
步骤如下:
在开始之前,请先检查是否满足如下要求:
根据文档下载 Fuchsia 源代码指示下载 Fuchsia 的源代码,然后在您的计算机上设置开发环境。
您只能在具有下列主机架构之一的计算机上构建 Fuchsia:
- x86-64 Linux (只支持基于 Debian 系列的发行版)
- x86-64 macOS
注意:不支持 Windows 和 ARM64。
Fuchsia 的构建配置告诉构建系统进行构建的产品,以及构建面向的平台。
要设置您的 Fuchsia 构建配置,请运行 fx set
命令:
fx set {{ '<var>' }}PRODUCT{{ '</var>' }}.{{ '<var>' }}BOARD{{ '</var>' }}
请替换以下选项:
PRODUCT
(产品):您想要构建的 Fuchsia 产品,比如:core
和workstation_eng
。BOARD
(板型):产品的可执行文件架构,比如:x64
和qemu-x64
。
下面的示例将一项构建配置设置为 core.qemu-x64
:
fx set core.qemu-x64
在这个示例中:
core
是 Fuchsia 具备最小功能集的产品,包括常用的网络功能。qemu-x64
是 Fuchsia 模拟器(FEMU)的 x64 架构这一板型,FEMU 基于开源模拟器 QEMU{:.external}。
另外,下面的例子将一项构建配置设置为 workstation_eng.x64
,这常用于在设备上安装 Fuchsia 工作站:
fx set workstation_eng.x64
要获取关于构建配置的更多信息,请参阅配置构建。
注意:这一步对于构建 Fuchsia 而言并不是必需的,但是可以在您构建 Fuchsia 时节省很多时间,因此建议您完成该步骤。
要提升 Fuchsia 构建速度,您可以使用下列服务之一:
Goma{:.external} 是一个分布式编译器服务,适用于 Chrome、Android 和 Fuchsia 等开源项目。
如果您能访问 Goma, 请在您的计算机上 Goma 客户端:
fx goma
如果您无法访问 Goma,但想在本地加速构建,则可以使用 ccache{:.external}
缓存之前构建的产物。
- {Linux}
要在 Linux 上使用 ccache
,请安装如下安装包:
sudo apt install ccache
- {macOS}
对于 macOS ,请参阅在 Mac 上使用 CCache{:.external} 中的安装步骤。
如果您的 CCACHE_DIR
环境变量指向已有路径,那么 ccache
就会自动开启。
要覆盖此默认行为,请为 fx set
指定以下标志:
-
即使其他的加速项可用,也要强制使用
ccache
,则:fx set PRODUCT.BOARD --ccache
- 要禁用
ccache
:fx set PRODUCT.BOARD --no-ccache
fx build
命令可以把源代码构建打包,或者构建成其他的类型。
要构建 Fuchsia,请运行以下命令:
注意:构建时间一般为 90 分钟。
fx build
当您修改源代码后,请再次运行命令 fx build
进行增量构建,或者运行 fx -i build
命令来开启一个监视进程,这个监视进程会在发现源代码更新时自动构建。
要获取关于构建 Fuchsia 的更多信息,请参阅执行构建。
要在您的计算机上启动 Fuchsia 模拟器 (FEMU),请参阅开启 Fuchsia 模拟器。
不过,如果您想在硬件设备上运行 Fuchsia,请参阅在设备上安装 Fuchsia。