blocklet dev コマンドは、ローカル開発にとって極めて重要なツールです。実行中の Blocklet Server インスタンスに接続し、ライブリローディング開発モードで blocklet を実行します。これにより、一時的なコンポーネントとして blocklet のインストール、起動、ログストリーミングが自動的に処理され、迅速なイテレーションが可能になります。
このコマンドを実行すると、いくつかの主要なアクションが実行されます：
サーバーへの接続
まず、ローカルの Blocklet Server が実行中であることを確認し、接続を確立します。
コンポーネントとしてインストール
現在の作業ディレクトリから Blocklet Server に、「開発」モードのコンポーネントとして blocklet をインストールします。親アプリケーションが指定されている場合は、そのアプリケーション内にインストールされます。それ以外の場合は、新しいコンテナアプリケーションが作成されます。
Blocklet の起動
blocklet と必要なサービスを起動します。
ログのストリーミング
リアルタイムのフィードバックのために、blocklet のログを直接ターミナルに出力します。
アクセス URL の提供
実行中の blocklet にアクセスできる URL を出力します。
自動クリーンアップ
コマンドを終了すると（例：
Ctrl+C）、開発コンポーネントが自動的に削除され、環境がクリーンアップされます。
この統合されたプロセスは開発サイクルを合理化し、CLI がランタイム環境を管理する間、開発者はコーディングに集中できます。
コマンドの使用法
開発モードに入るための主要なコマンドは blocklet dev です。
blocklet devこのコマンドは、現在のディレクトリから blocklet をインストールして起動します。
サブコマンド
dev コマンドには、完全な開発セッションを開始せずに開発ライフサイクルを管理するためのいくつかのサブコマンドも含まれています。
| Command | Description |
|---|---|
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— 起動後、デフォルトの Web ブラウザで 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 をパッケージ化することです。詳細については、パッケージングとバージョニング に関するドキュメントを参照してください。