本指南說明如何在主體機器上設定及建構 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 產品,例如core
和workbench_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。