本文件將逐步說明如何使用 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 映像檔的初始建構和閃燈作業,請執行下列操作:
設定 Fuchsia 建構設定:
fx set core.x64
這會將建構設定為在通用 x64 主機板上建構
core
產品。如需可用產品和電路板的清單,請分別參閱fx list-products
和fx list-boards
中的可用產品清單。建構 Fuchsia 映像檔:
fx build
這個指令會先建構 Zircon,然後再建構 Fuchsia 的其他部分。
建構 Zedboot 媒體,並安裝至 USB 裝置目標:
fx mkzedboot <usb_drive_device_path>
如要瞭解如何取得 USB 隨身碟裝置路徑,請參閱「USB 隨身碟裝置路徑」。
將 Zedboot USB 隨身碟連接至目標裝置,然後重新啟動該裝置。
在目標裝置上執行:
install-disk-image init-partition-tables
在主機上啟動啟動伺服器:
fx flash
啟動伺服器會連線至目標裝置,上傳 Fuchsia 映像檔,然後對目標裝置進行閃燈。
重新建構並重新刷新 Fuchsia
如要使用 fx
工具重新部署 Fuchsia,請執行下列操作:
- 請確認 HEAD 處於可拉取的良好狀態,並在建構資訊主頁中查看。
擷取最新程式碼:
jiri update
建構 Fuchsia 映像檔:
fx build
這個指令會先建構 Zircon,然後再建構 Fuchsia 的其他部分。
在主機上啟動開發套件伺服器:
fx serve
在不連接 Zedboot USB 的情況下,啟動目標裝置。
從主機將更新的 Fuchsia 套件推送至目標裝置:
fx ota
在某些情況下,如果
fx ota
未順利完成,請考慮使用fx flash
重新鋪面。
疑難排解
如果 fx build
失敗,請確認 PATH
環境變數設定正確無誤。
如何檢查 PATH
變數的值:
echo $PATH
請確認 PATH
變數的輸出內容是用冒號分隔的資料夾清單。請確認所有目錄都沒有以點號 (.
) 分隔。