設定及建構 Fuchsia

本指南提供操作說明，說明如何在主機上設定及建構 Fuchsia。

步驟如下：

  1. 必要條件。
  2. 設定建構設定。
  3. 加快建構速度 (選用)。
  4. 建構 Fuchsia。

必要條件

本指南需要下列必要項目：

設定原始碼

完成「下載 Fuchsia 原始碼」指南。 本指南說明如何下載 Fuchsia 原始碼，並在主機上設定 Fuchsia 開發環境。

硬體需求

您可以在採用 x86-64 Linux 架構的主機上建構 Fuchsia (僅限以 Debian 為基礎的發行版本)。

不支援 Windows。

設定建構設定

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

如要設定 Fuchsia 建構設定，請執行下列fx set指令：

fx set PRODUCT.BOARD

請替換下列項目：

  • PRODUCT：要建構的 Fuchsia 產品，例如 core 和 workbench_eng。
  • BOARD：主機板設定，例如 x64 或 qemu-arm64。

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

fx set core.x64
  • core 是 Fuchsia 的最低功能集產品，包括網路功能。
  • x64 可以在各種 x64 裝置上執行，包括 Fuchsia 模擬器 (FEMU)。

另一方面，以下範例會將建構設定設為 workbench_eng.x64：

fx set workbench_eng.x64

系統會從 Fuchsia 來源存放區的根目錄彙整可能的開發板和產品清單。詳情請參閱「設定建構作業」。

加快建構速度 (選用)

如要在本機加速 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 指令會執行建構作業，將原始碼轉換為套件和其他建構構件。

如要建構 Fuchsia，請執行下列指令：

fx build

修改原始碼後，請再次執行 fx build 指令，執行增量建構作業，或執行 fx -i build 指令啟動監控程式，每當您更新原始碼時，監控程式就會自動建構。

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

後續步驟

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

不過，如要在硬體裝置上執行 Fuchsia，請改為參閱「在裝置上安裝 Fuchsia」。