本文件說明如何使用 fx
開發指令,在目標裝置上建構及部署 Fuchsia。上述指令大多都有其他指令,詳情請參閱 fx help <command>
。
判斷 USB 隨身碟裝置路徑
在嘗試在目標裝置上建構及設定 Fuchsia 之前,您需要瞭解 USB 隨身碟的路徑。
fx
如何找出 USB 隨身碟的正確路徑:
fx mkzedboot
Linux
如何找出 USB 隨身碟的正確路徑:
sudo fdisk -l
磁碟的格式為 /dev/sd[x]
,例如 /dev/sdc
。
請務必選取磁碟機,而非特定分區。例如,特定分區的路徑結尾處有數字,例如 /dev/sdc1
。
macOS
如何找出 USB 隨身碟的正確路徑:
diskutil list | grep external
磁碟的格式為 /dev/disk[n]
,例如 /dev/disk2
。
hdiutil unmount /dev/disk[n]
如果仍無法解決問題,請嘗試重新設定雲端硬碟格式:
diskutil eraseDisk JHFSX <name_of_the_usb_stick> /dev/disk[n]
建構及部署 Fuchsia
如要使用 fx
執行 Fuchsia 的初始建構及部署,請執行下列步驟:
設定建構類型:
fx set core.x64
建構 Fuchsia 映像檔:
fx build
這個指令會建構 Zircon,然後是 Fuchsia 的其他部分。
建構 Zedboot 媒體並安裝到 USB 裝置目標:
fx mkzedboot <usb_drive_device_path>
將 Zedboot USB 隨身碟連接至目標裝置,然後重新啟動裝置。
在目標裝置上,執行:
lsblk
請記下
lsblk
輸出內容中的 HDD 或 SSD 裝置路徑。路徑範例如/dev/sys/platform/pci/00:17.0/ahci/sata0/block
。在目標裝置上,執行:
install-disk-image init-partition-tables --block-device <BLOCK_DEVICE_PATH>
如要啟動啟動伺服器,請從主機執行下列指令:
fx pave
重新建構並重新部署 Fuchsia
如要使用 fx
重新建構及重新部署,請按照下列指示操作:
- 確認 HEAD 處於良好狀態,以便透過建構資訊主頁提取。
擷取最新的程式碼:
jiri update
建構 Fuchsia 映像檔:
fx build
這個指令會建構 Zircon,然後是 Fuchsia 的其他部分。
(僅適用於 macOS 使用者) 設定防火牆規則:
fx setup-macos
從您的主機啟動開發套件伺服器:
fx serve
在不連接 Zedboot USB 的情況下啟動目標裝置。
在主機中,將更新的 Fuchsia 套件推送至目標裝置:
fx ota
在某些情況下,如果
fx ota
並未順利完成,請考慮使用fx pave
進行傳回。
疑難排解
如果
fx build
失敗,請確認PATH
環境變數設定正確無誤。如要檢查
PATH
變數的值,請按照下列指示操作:echo $PATH
確認
PATH
變數的輸出內容為以冒號分隔的目錄清單。請確認沒有任何目錄以.
分隔。