建構及刷新 Fuchsia

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

找出 USB 隨身碟裝置路徑

您必須先找出 USB 磁碟機的路徑,才能在目標裝置上建構及刷新 Fuchsia。

建議您在 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 變數的輸出內容是用冒號分隔的資料夾清單。請確認所有目錄都沒有以點號 (.) 分隔。