Skip to content

Latest commit

 

History

History
271 lines (261 loc) · 9.51 KB

build_fuchsia.md

File metadata and controls

271 lines (261 loc) · 9.51 KB

配置和构建 Fuchsia {#configure-and-build-fuchsia}

这篇文档将引导您在主机上配置并构建 Fuchsia。

步骤如下:

  1. 前提条件
  2. 设置构建配置
  3. 提升构建速度(可选)
  4. 构建 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 {{ '<var>' }}PRODUCT{{ '</var>' }}.{{ '<var>' }}BOARD{{ '</var>' }}

请替换以下选项:

  • PRODUCT(产品):您想要构建的 Fuchsia 产品,比如:coreworkstation_eng
  • BOARD(板型):产品的可执行文件架构,比如:x64qemu-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

要获取关于构建配置的更多信息,请参阅配置构建

3. 提升构建速度(可选) {#speed-up-the-build}

注意:这一步对于构建 Fuchsia 而言并不是必需的,但是可以在您构建 Fuchsia 时节省很多时间,因此建议您完成该步骤。

要提升 Fuchsia 构建速度,您可以使用下列服务之一:

启用 Goma {#enable-goma}

Goma{:.external} 是一个分布式编译器服务,适用于 Chrome、Android 和 Fuchsia 等开源项目。

如果您能访问 Goma, 请在您的计算机上 Goma 客户端:

fx goma

安装 ccache {#install-ccache}

如果您无法访问 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
    

4. 构建 Fuchsia {#build-fuchsia}

fx build 命令可以把源代码构建打包,或者构建成其他的类型。

要构建 Fuchsia,请运行以下命令:

注意:构建时间一般为 90 分钟。

fx build

当您修改源代码后,请再次运行命令 fx build 进行增量构建,或者运行 fx -i build 命令来开启一个监视进程,这个监视进程会在发现源代码更新时自动构建。

要获取关于构建 Fuchsia 的更多信息,请参阅执行构建

后续步骤

要在您的计算机上启动 Fuchsia 模拟器 (FEMU),请参阅开启 Fuchsia 模拟器

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