配置和构建 Fuchsia

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

具体步骤如下：

  1. 前提条件。
  2. 设置 build 配置。
  3. 加快构建速度（可选）。
  4. 构建 Fuchsia。

前提条件

本指南需要满足以下前提条件：

源代码设置

完成下载 Fuchsia 源代码指南。 本指南可帮助您下载 Fuchsia 源代码，并在主机上设置 Fuchsia 开发环境。

硬件要求

您可以在具有 x86-64 Linux 架构（仅限基于 Debian 的发行版）的主机上构建 Fuchsia。

不支持 Windows。

设置 build 配置

Fuchsia 的 build 配置会告知 build 系统要构建哪个产品以及要使用哪个架构。

如需设置 Fuchsia build 配置，请运行以下 fx set 命令：

fx set PRODUCT.BOARD

替换以下内容：

  • PRODUCT：要构建的 Fuchsia 产品，例如 core 和 workbench_eng。
  • BOARD：板级配置；例如 x64 或 qemu-arm64。

以下命令示例将 build 配置设置为 core.x64：

fx set core.x64
  • core 是具有最小 Fuchsia 功能集的产品，其中包括网络功能。
  • x64 是一款可在各种 x64 设备上运行的主板，包括 Fuchsia 模拟器 (FEMU)。

另一方面，以下示例将 build 配置设置为 workbench_eng.x64：

fx set workbench_eng.x64

可能的主板和产品列表是从 Fuchsia 源代码库的根目录汇总而来的。如需了解详情，请参阅配置 build。

加快构建速度（可选）

如需在本地加快 Fuchsia 构建速度，请使用 ccache 缓存之前构建的 C 和 C++ 制品。

安装 ccache 软件包：

sudo apt install ccache

如果 CCACHE_DIR 环境变量引用的是现有目录，系统会自动启用 ccache。

如需替换此默认行为，请为 fx set 指定以下标志：

  • 强制使用 ccache，即使有其他加速器可用：

    fx set PRODUCT.BOARD --ccache

  • 停用 ccache：

    fx set PRODUCT.BOARD --no-ccache

构建 Fuchsia

fx build 命令会执行 build，将源代码转换为软件包和其他 build 制品。

如需构建 Fuchsia，请运行以下命令：

fx build

修改源代码后，再次运行 fx build 命令以执行增量 build，或运行 fx -i build 命令以启动监视器，该监视器会在您更新源代码时自动执行 build。

如需详细了解如何构建 Fuchsia，请参阅执行 build。

后续步骤

如需在您的机器上启动 Fuchsia 模拟器 (FEMU)，请参阅启动 Fuchsia 模拟器。

不过，如果您想在硬件设备上运行 Fuchsia，请改为参阅在设备上安装 Fuchsia。