跳到主要內容

開發模式

blocklet dev 指令是本地開發的關鍵工具。它會在即時重載的開發模式下執行您的 blocklet,並將其連接到一個正在執行的 Blocklet Server 實例。這會自動處理您的 blocklet 作為臨時元件的安裝、啟動和日誌串流,從而實現快速迭代。

當您執行此指令時,它會執行以下幾個關鍵操作:

  1. 連接到伺服器

    它首先確保本地 Blocklet Server 正在執行並建立連線。

  2. 作為元件安裝

    它會將您目前工作目錄中的 blocklet 作為「開發」模式下的元件安裝到 Blocklet Server 中。如果指定了父應用程式,它會被安裝在該應用程式內;否則,會為其建立一個新的容器應用程式。

  3. 啟動 Blocklet

    它會啟動 blocklet 及任何必要的服務。

  4. 串流日誌

    它會將 blocklet 的日誌直接傳送到您的終端機,以提供即時反饋。

  5. 提供存取 URL

    它會輸出您可以存取正在執行的 blocklet 的 URL。

  6. 自動清理

    當您終止指令時(例如,使用 Ctrl+C),它會自動移除開發元件並清理環境。

這個整合的流程簡化了開發週期,讓您能專注於編碼,而 CLI 則負責管理執行環境。

Develop Mode

指令用法

進入開發模式的主要指令是 blocklet dev

bash
blocklet dev

此指令會從目前目錄安裝並啟動 blocklet。

子指令

dev 指令還包含幾個子指令,用於管理開發生命週期,而無需啟動完整的開發會話。

指令說明
blocklet dev install在開發模式下安裝 blocklet,但不會啟動它。適用於預先配置環境。
blocklet dev remove移除先前在開發模式下安裝的 blocklet。
blocklet dev reset重設 blocklet 的資料,清除其狀態,而無需完全重新安裝。
blocklet dev faucet為 blocklet 的錢包從已配置的測試網水龍頭領取代幣。
blocklet dev studio在您的瀏覽器中為指定的 blocklet 開啟元件工作室。

選項

您可以使用以下選項自訂 dev 指令的行為:

  • --app-did string — 指定要將 blocklet 安裝到的現有父應用程式的 DID。如果省略,將為該 blocklet 建立一個新的應用程式容器。
  • --mount-point string — 定義 blocklet 元件將被掛載的 URL 路徑(例如,/my-blocklet)。使用 --app-did 時為必填項。
  • --open boolean — 在 blocklet 啟動後,在您的預設網頁瀏覽器中自動開啟其存取 URL。
  • --store-url string — 指定一個元件商店 URL 以解析元件相依性。會覆蓋預設的商店 URL。
  • --start-all-components boolean — 在較大的應用程式中開發元件時,此旗標將啟動該應用程式中的所有其他元件,而不僅僅是正在開發的元件。
  • --host string — 使用 faucet 子指令時,指定水龍頭主機的 URL。
  • --token string — 使用 faucet 子指令時,指定要從水龍頭請求的代幣地址或符號。

前提條件

在使用 blocklet dev 之前,您必須在本地執行一個 Blocklet Server 實例。如果伺服器未執行,該指令將會失敗。

您可以使用以下指令啟動伺服器:

bash
blocklet server start

更多詳情,請參閱 啟動伺服器 文件。

範例

基本開發

若要開始開發位於您目前目錄中的 blocklet,只需執行:

bash
blocklet dev --open

CLI 將會安裝並啟動 blocklet,將其日誌串流至您的控制台,並在您的瀏覽器中開啟其 URL。

為現有應用程式開發元件

如果您正在開發一個旨在成為較大應用程式元件的 blocklet,您可以指定父應用程式的 DID 和掛載點。

bash
blocklet dev --app-did zNKe4B62j5e9i6rWzM9adcee19s323j4s2pG --mount-point /my-component

此指令將會:

  1. 找到具有指定 DID (zNKe...) 的應用程式。
  2. 將您的本地 blocklet 作為元件安裝到該應用程式中。
  3. 使其可透過相對於應用程式主 URL 的 /my-component 路徑存取。

重設 Blocklet 資料

如果您需要清除與您的開發 blocklet 相關的所有資料和狀態,以測試乾淨的安裝流程,請使用 reset 子指令。

bash
blocklet dev reset

這比移除並重新安裝 blocklet 要快得多。

總結

blocklet dev 指令是本地 blocklet 開發的基石,提供了一個無縫且高效的工作流程。它彌合了您的本地原始碼與即時 Blocklet Server 環境之間的差距。

在本地迭代後,接下來的步驟是打包您的 blocklet 以進行分發。更多資訊,請參閱關於 打包與版本控制 的文件。