快速入門導覽課程:建立及設定快速入門導覽課程

本文件說明如何使用 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 的初始建構及部署,請執行下列步驟:

  1. 設定建構類型:

    fx set core.x64
    
  2. 建構 Fuchsia 映像檔:

    fx build
    

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

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

    fx mkzedboot <usb_drive_device_path>
    
  4. 將 Zedboot USB 隨身碟連接至目標裝置,然後重新啟動裝置。

  5. 在目標裝置上,執行:

    lsblk
    
  6. 請記下 lsblk 輸出內容中的 HDD 或 SSD 裝置路徑。路徑範例如 /dev/sys/platform/pci/00:17.0/ahci/sata0/block

  7. 在目標裝置上,執行:

    install-disk-image init-partition-tables --block-device <BLOCK_DEVICE_PATH>
    
  8. 如要啟動啟動伺服器,請從主機執行下列指令:

    fx pave
    

重新建構並重新部署 Fuchsia

如要使用 fx 重新建構及重新部署,請按照下列指示操作:

  1. 確認 HEAD 處於良好狀態,以便透過建構資訊主頁提取。
  2. 擷取最新的程式碼:

    jiri update
    
  3. 建構 Fuchsia 映像檔:

    fx build
    

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

  4. (僅適用於 macOS 使用者) 設定防火牆規則:

    fx setup-macos
    
  5. 從您的主機啟動開發套件伺服器:

    fx serve
    
  6. 在不連接 Zedboot USB 的情況下啟動目標裝置。

  7. 在主機中,將更新的 Fuchsia 套件推送至目標裝置:

    fx ota
    

    在某些情況下,如果 fx ota 並未順利完成,請考慮使用 fx pave 進行傳回。

疑難排解

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

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

    echo $PATH
    

    確認 PATH 變數的輸出內容為以冒號分隔的目錄清單。請確認沒有任何目錄以 . 分隔。