メインコンテンツへスキップ

コンポーネント管理

Blockletは他のBlockletで構成でき、それらはコンポーネントと呼ばれます。この強力な機能により、より小さく、再利用可能な部品を組み立てることで、複雑なアプリケーションを構築できます。Blocklet CLIは、プロジェクトのblocklet.ymlファイル内でこれらのコンポーネント依存関

Blockletは他のBlockletで構成でき、それらはコンポーネントと呼ばれます。この強力な機能により、より小さく、再利用可能な部品を組み立てることで、複雑なアプリケーションを構築できます。Blocklet CLIは、プロジェクトのblocklet.ymlファイル内でこれらのコンポーネント依存関係を管理するための一連のコマンドを提供します。

このセクションでは、Blockletプロジェクトでコンポーネントを追加、削除、操作する方法について説明します。

コンポーネントの追加

blocklet addコマンドは、現在のプロジェクトに新しいBlockletをコンポーネントとして追加します。blocklet.ymlファイルのcomponentsセクションを自動的に更新し、循環依存関係をチェックします。

Command

bash
blocklet add <name>[@<version>] | <url> [options]

設定済みのBlockletストアから名前とオプションのバージョンを指定してコンポーネントを追加するか、メタデータを指すURLから直接追加することができます。

例:

  • ストアから追加: Add from store bash blocklet add my-component@1.2.3
  • URLから追加: Add from URL bash blocklet add https://example-store.com/blocklets/z8i.../blocklet.json

このコマンドは、blocklet.ymlに次のような新しいエントリを追加します:

blocklet.yml

yaml
components:
  - name: my-component
    title: マイコンポーネント
    mountPoint: /my-component
    source:
      store: 'https://store.blocklet.dev'
      name: my-component
      version: 1.2.3

詳細については、コンポーネントの追加ドキュメントを参照してください。

コンポーネントの削除

blocklet removeコマンドは、プロジェクトからコンポーネント依存関係を削除します。blocklet.ymlで名前によってコンポーネントを見つけ、その設定エントリを削除します。

Command

bash
blocklet remove <component-name>

例:

Remove a component

bash
blocklet remove my-component

これにより、blocklet.ymlcomponents配列から対応するコンポーネントオブジェクトが削除されます。

詳細については、コンポーネントの削除ドキュメントを参照してください。

Component Studio CLI

blocklet componentコマンドは、@blocklet/component-studio-cliを実行する便利なラッパーです。この専用ツールは、コンポーネントを扱うためのより高度な機能を提供します。

blocklet componentに渡す引数は、Component Studio CLIに直接転送されます。

Command

bash
blocklet component [args...]

例:

Component Studio CLIにlistというコマンドがある場合、次のように実行できます:

Proxy a command

bash
blocklet component list

これは、内部でnpx -y @blocklet/component-studio-cli listを実行します。

詳細については、Component Studio CLIドキュメントを参照してください。