建立並執行工作階段

工作階段是指裝置啟動時啟動的第一個產品專屬元件。工作階段元件負責建構產品的使用者體驗。

啟動工作階段

如要啟動工作階段，請執行下列步驟：

1. 您必須使用工作階段的網址設定產品版本，才能在啟動時執行工作階段。找出工作階段的元件網址：

   
      fuchsia-pkg://fuchsia.com/pkg-name#meta/your_session.cm
   

   更改下列內容：

   • pkg-name：套件名稱
   • your_session.cm：工作階段的名稱，包括 .cm 副檔名。

   詳情請參閱 fuchsia-pkg 和套件名稱相關說明。

2. 執行下列指令，在基本映像檔中加入 session_manager 和 your_session，設定 session_manager 即可啟動工作階段：

   
     fx set product.board \
        --with-base=//src/session/bin/session_manager \
        --with-base=//path/to/your/session \
        --args=product_config.session_url="fuchsia-pkg://fuchsia.com/pkg-name#meta/your_session.cm"
   

   fx list-products 和 fx list-boards 會顯示可在 fx set 指令中使用的產品和主面板清單。如要進一步瞭解 fx 指令，請參閱「fx 說明文件」。

3. 重新打造裝置，並重新裝上裝置。

   fx build
   fx ota
   

   這會使 session_manager 啟動並啟動工作階段。

如需建構工作階段元件的完整說明，請參閱編寫 Hello World 工作階段。

透過指令列啟動工作階段

在某些情況下，您可能不希望工作階段在啟動時啟動，但仍想透過指令列啟動工作階段。需要執行 session_manager 才能啟動工作階段。session_manager 目標會確保 session_manager 本身啟動，但不會啟動工作階段。

如要透過指令列啟動工作階段，請按照下列步驟操作：

1. 除了工作階段目標外，請在基礎依附元件集中新增 session_manager 目標。

   fx set product.board --with-base=//src/session/bin/session_manager --with=//path/to/your/session

   fx list-products 和 fx list-boards 會顯示可在 fx set 指令中使用的產品和主面板清單。如要進一步瞭解 fx 指令，請參閱「fx 說明文件」。

2. 請執行下列指令，重新建構及退回裝置：

   fx build
   fx ota
   

   這會讓 session_manager 在不啟動工作階段的情況下啟動。

3. 您現在可以透過指令列啟動工作階段。

   執行下列指令來啟動工作階段：

   ffx session launch fuchsia-pkg://fuchsia.com/pkg-name#meta/your_session.cm

   如要進一步瞭解 ffx session 指令，請執行 ffx session --help。如要進一步瞭解 ffx，請參閱 ffx documentation。