建構及刷新 Fuchsia

本文將逐步說明如何使用 fx 指令,在硬體裝置上建構及刷入 Fuchsia 映像檔。

找出 USB 隨身碟的裝置路徑

如要在目標裝置上建構及刷新 Fuchsia,請先找出 USB 隨身碟的路徑。

建議先拔除 USB 隨身碟,然後執行下列指令一次,接著再插入 USB 隨身碟,然後再次執行指令,查看兩者差異。

fx 工具

如要使用 fx 工具檢查 USB 磁碟機的正確路徑,請執行下列指令:

fx mkzedboot

fx 工具與平台無關,會列出可用的 USB 隨身碟。

Linux 指令

如要使用 Linux 指令檢查 USB 隨身碟的正確路徑,請執行下列指令:

sudo fdisk -l

磁碟通常採用 /dev/sd* 格式,例如 /dev/sdc。請務必選取磁碟機,而非特定分割區。舉例來說,特定分區的路徑結尾會有數字,例如 /dev/sdc1

建構及刷入 Fuchsia

如要使用 fx 工具執行初始建構及刷新 Fuchsia 映像檔,請按照下列步驟操作:

  1. 設定 Fuchsia 建構設定:

    fx set core.x64

    這項設定會將建構作業設定為在一般 x64 開發板上建構 core 產品。如要查看可用的產品和開發板清單,請分別參閱 fx list-productsfx list-boards

  2. 建構 Fuchsia 映像檔:

    fx build

    這個指令會建構 Zircon,然後建構 Fuchsia 的其餘部分。

  3. 建構 Zedboot 媒體,並安裝至 USB 裝置目標:

    fx mkzedboot <usb_drive_device_path>

    如要瞭解如何取得 USB 隨身碟裝置路徑,請參閱「USB 隨身碟裝置路徑」。

  4. 將 Zedboot USB 隨身碟連接至目標裝置,然後重新啟動該裝置。

  5. 在目標裝置上執行下列指令:

    install-disk-image init-partition-tables
  6. 從主機啟動啟動伺服器:

    fx flash

    開機伺服器會連線至目標裝置,上傳 Fuchsia 映像檔,然後將映像檔刷入目標裝置。

重新建構並重新刷寫 Fuchsia

如要使用 fx 工具重新部署 Fuchsia,請按照下列步驟操作:

  1. 請確保 HEAD 狀態良好,可從建構資訊主頁提取。
  2. 擷取最新程式碼:

    jiri update
  3. 建構 Fuchsia 映像檔:

    fx build

    這個指令會建構 Zircon,然後建構 Fuchsia 的其餘部分。

  4. 從主機啟動開發套件伺服器:

    fx serve
  5. 啟動目標裝置,但不要連接 Zedboot USB。

  6. 從主機將更新的 Fuchsia 封裝推送至目標裝置:

    fx ota

    在某些情況下,如果 fx ota 未順利完成,請考慮使用 fx flash 重新鋪設。

疑難排解

如果 fx build 失敗,請確認 PATH 環境變數已正確設定。

如要檢查 PATH 變數的值,請按照下列步驟操作:

echo $PATH

請確認 PATH 變數的輸出內容是以半形冒號分隔的目錄清單。請確認目錄之間沒有以半形句號 (.) 分隔。