跳到主要内容

组件管理

Blocklet 可以由其他 Blocklet 组成，这些 Blocklet 被称为组件。这个强大的功能允许您通过组装更小的、可复用的部分来构建复杂的应用程序。Blocklet CLI 提供了一组命令来帮助您在项目的 blocklet.yml 文件中管理这些组件依赖。

本节将介绍如何在您的 Blocklet 项目中添加、移除组件以及与组件进行交互。

添加组件

了解如何向您的 Blocklet 添加新的组件依赖。

移除组件

了解如何从您的 Blocklet 中移除现有的组件依赖。

组件 Studio CLI

与组件 Studio 交互以执行高级组件管理任务。

添加组件

blocklet add 命令将一个新的 Blocklet 作为组件添加到您当前的项目中。它会自动更新您 blocklet.yml 文件中的 components 部分，并检查循环依赖。

Command

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

您可以通过指定组件的名称和可选的版本号，从已配置的 Blocklet Store 中添加组件，或者直接从指向其元数据的 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: My Component
    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.yml 的 components 数组中移除相应的组件对象。

更多详情，请参阅 移除组件 文档。

组件 Studio CLI

blocklet component 命令是一个方便的包装器，它会执行 @blocklet/component-studio-cli。这个专门的工具为处理组件提供了更高级的功能。

您传递给 blocklet component 的任何参数都会直接转发给组件 Studio CLI。

Command

bash
blocklet component [args...]

示例：

如果组件 Studio CLI 有一个名为 list 的命令，您可以像这样运行它：

Proxy a command

bash
blocklet component list

这会在后台执行 npx -y @blocklet/component-studio-cli list。

更多详情，请参阅 组件 Studio CLI 文档。