blocklet dev 指令是本地開發的關鍵工具。它會在即時重載的開發模式下執行您的 blocklet,並將其連接到一個正在執行的 Blocklet Server 實例。這會自動處理您的 blocklet 作為臨時元件的安裝、啟動和日誌串流,從而實現快速迭代。
當您執行此指令時,它會執行以下幾個關鍵操作:
連接到伺服器
它首先確保本地 Blocklet Server 正在執行並建立連線。
作為元件安裝
它會將您目前工作目錄中的 blocklet 作為「開發」模式下的元件安裝到 Blocklet Server 中。如果指定了父應用程式,它會被安裝在該應用程式內;否則,會為其建立一個新的容器應用程式。
啟動 Blocklet
它會啟動 blocklet 及任何必要的服務。
串流日誌
它會將 blocklet 的日誌直接傳送到您的終端機,以提供即時反饋。
提供存取 URL
它會輸出您可以存取正在執行的 blocklet 的 URL。
自動清理
當您終止指令時(例如,使用
Ctrl+C),它會自動移除開發元件並清理環境。
這個整合的流程簡化了開發週期,讓您能專注於編碼,而 CLI 則負責管理執行環境。

指令用法
進入開發模式的主要指令是 blocklet dev。
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 實例。如果伺服器未執行,該指令將會失敗。
您可以使用以下指令啟動伺服器:
blocklet server start更多詳情,請參閱 啟動伺服器 文件。
範例
基本開發
若要開始開發位於您目前目錄中的 blocklet,只需執行:
blocklet dev --openCLI 將會安裝並啟動 blocklet,將其日誌串流至您的控制台,並在您的瀏覽器中開啟其 URL。
為現有應用程式開發元件
如果您正在開發一個旨在成為較大應用程式元件的 blocklet,您可以指定父應用程式的 DID 和掛載點。
blocklet dev --app-did zNKe4B62j5e9i6rWzM9adcee19s323j4s2pG --mount-point /my-component此指令將會:
- 找到具有指定 DID (
zNKe...) 的應用程式。 - 將您的本地 blocklet 作為元件安裝到該應用程式中。
- 使其可透過相對於應用程式主 URL 的
/my-component路徑存取。
重設 Blocklet 資料
如果您需要清除與您的開發 blocklet 相關的所有資料和狀態,以測試乾淨的安裝流程,請使用 reset 子指令。
blocklet dev reset這比移除並重新安裝 blocklet 要快得多。
總結
blocklet dev 指令是本地 blocklet 開發的基石,提供了一個無縫且高效的工作流程。它彌合了您的本地原始碼與即時 Blocklet Server 環境之間的差距。
在本地迭代後,接下來的步驟是打包您的 blocklet 以進行分發。更多資訊,請參閱關於 打包與版本控制 的文件。