設定及建構 Fuchsia

本指南說明如何在主體機器上設定及建構 Fuchsia。

步驟如下:

  1. 必備條件
  2. 進行建構設定
  3. 加速建構 (選用)
  4. Build Fuchsia

1. 必要條件

開始之前,請先查看下列要求:

原始碼設定

完成下載 Fuchsia 原始碼指南,下載 Fuchsia 原始碼,並在您的電腦上設定 Fuchsia 開發環境。

硬體需求

您可以使用下列其中一種架構,在主機機器上建構 Fuchsia:

  • x86-64 Linux (僅限以 Debian 為基礎的發行版本)
  • x86-64 macOS
  • ARM64 macOS

2. 調整建構設定

Fuchsia 的建構設定會告知建構系統要建構哪項產品,以及要建構哪個架構。

如要調整 Fuchsia 建構設定,請執行下列 fx set 指令:

fx set PRODUCT.BOARD

更改下列內容:

  • PRODUCT:您要建構的 Fuchsia 產品,例如 coreworkbench_eng
  • BOARD:產品的架構,例如 x64

下列範例指令會將建構設定設為 core.x64

fx set core.x64

在這個例子中:

  • core 為採用 Fuchsia 最低功能組合的產品,包括常見的網路功能。
  • x64 是一款在各種 x64 裝置上執行的 Jamboard,包括以開放原始碼模擬器 QEMU 為基礎的 Fauchsia 模擬器 (FEMU)。

另一方面,以下範例會將建構設定設為 workbench_eng.x64,這通常用於在裝置上安裝 Fuchsia 的 Workbench 產品

fx set workbench_eng.x64

可用的主面板和產品的清單是動態的。這兩份清單可以從 Fuchsia 存放區的根層級開始收集。若是主面板,請參閱主面板

請參閱產品

如要進一步瞭解建構設定,請參閱「建構設定」。

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 指令啟動看守工具,此項目會在您每次更新原始碼時自動建構。

如要進一步瞭解如何建構 Fuchsia,請參閱「執行建構」。

後續步驟

如要在電腦上啟動 Fuchsia 模擬器 (FEMU),請參閱「啟動 Fuchsia 模擬器」。

不過,如要在硬體裝置上執行 Fuchsia,請改為參閱在裝置上安裝 Fuchsia