本指南介绍了如何在主机上配置和构建 Fuchsia。
相关步骤如下:
1. 前提条件
开始之前,请先查看以下要求:
源代码设置
完成下载 Fuchsia 源代码指南,下载 Fuchsia 源代码,并在计算机上设置 Fuchsia 开发环境。
硬件要求
您可以使用以下任一架构在主机上构建 Fuchsia:
- x86-64 Linux(仅限基于 Debian 的发行版)
- x86-64 macOS
- ARM64 macOS
2. 设置 build 配置
Fuchsia 的 build 配置会告知构建系统要构建哪个产品以及要针对哪个架构进行构建。
如需设置 Fuchsia build 配置,请运行以下 fx set
命令:
fx set PRODUCT.BOARD
替换以下内容:
PRODUCT
:您要构建的 Fuchsia 产品;例如core
和workbench_eng
。BOARD
:产品的架构;例如x64
。
以下示例命令将 build 配置设为 core.x64
:
fx set core.x64
在此示例中:
core
是具有最低 Fuchsia 功能集(包括常用网络功能)的产品。x64
是一种可在各种 x64 设备上运行的开发板,包括基于开源模拟器 QEMU 的 Fuchsia 模拟器 (FEMU)。
另一方面,以下示例将 build 配置设置为 workbench_eng.x64
,这通常用于在设备上安装 Fuchsia 的工作台产品:
fx set workbench_eng.x64
可能的面板和产品的列表是动态的。这两个列表可以从 Fuchsia 代码库的根目录开始收集。如需了解开发板,请参阅开发板
如需了解产品,请参阅产品
如需详细了解 build 配置,请参阅配置 build。
3. 加快构建速度(可选)
要加快 Fuchsia 构建速度,您可以使用以下服务之一:
启用 Goma
Goma 是一项适用于 Chrome、Android 和 Fuchsia 等开源项目的分布式编译器服务。
如果您有权访问 Goma,请在您的计算机上启用 Goma 客户端:
fx goma
安装 ccache
如果您无权访问 Goma,但希望在本地加速 Fuchsia 构建,请使用 ccache
缓存以前构建中的工件。
Linux
如需在 Linux 上使用 ccache
,请安装以下软件包:
sudo apt install ccache
macOS
对于 macOS,请参阅在 Mac 上使用 CCache 了解安装说明。
如果您的 CCACHE_DIR
环境变量引用现有目录,系统会自动启用 ccache
。
如需替换此默认行为,请为 fx set
指定以下标志:
即使有其他加速器可用,也强制使用
ccache
:fx set PRODUCT.BOARD --ccache
停用
ccache
:fx set PRODUCT.BOARD --no-ccache
4. 构建 Fuchsia
fx build
命令会执行构建,以将源代码转换为软件包和其他构建工件。
如需构建 Fuchsia,请运行以下命令:
fx build
修改源代码时,请再次运行 fx build
命令以执行增量构建,或者运行 fx -i build
命令来启动 Watcher,每当您更新源代码时,该 Watcher 都会自动构建。
如需详细了解如何构建 Fuchsia,请参阅执行构建。
后续步骤
如需在计算机上启动 Fuchsia 模拟器 (FEMU),请参阅启动 Fuchsia 模拟器。
但是,如果您想在硬件设备上运行 Fuchsia,请改为参阅在设备上安装 Fuchsia。