配置和构建 Fuchsia

本指南介绍了如何在主机上配置和构建 Fuchsia。

相关步骤如下:

  1. 前提条件
  2. 设置 build 配置
  3. 加快构建速度(可选)
  4. 构建 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 产品;例如 coreworkbench_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