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