跳到主要内容

创建项目

blocklet create 命令是启动新 Blocklet 项目的最快方法。它使用 create-blocklet，这是一个交互式脚手架工具，可让您从各种官方入门模板中进行选择。此命令是引导新应用程序的推荐方法。

blocklet create 命令是启动新 Blocklet 项目的最快方法。它使用 create-blocklet，这是一个交互式脚手架工具，可让您从各种官方入门模板中进行选择。此命令是引导新应用程序的推荐方法。

用法

该命令可作为 npx create-blocklet@latest 的便捷包装器。

命令

bash
blocklet create [name] [options]

参数

  • [name] string — 新 Blocklet 项目的名称。如果省略该名称，交互式设置过程将提示您输入一个。

工作原理

运行 blocklet create 会启动一个交互式命令行界面，引导您完成设置过程。系统将提示您：

  1. 输入您的 Blocklet 名称（如果未作为参数提供）。
  2. 选择一个入门模板（例如，React、Vue、Static 等）。

然后，该工具将使用指定的名称创建一个新目录，下载模板，并安装必要的依赖项。

示例

要启动交互式会话，只需运行不带任何参数的命令：

交互模式

bash
blocklet create

如果您已经想好了名称，可以直接提供：

直接模式

bash
blocklet create my-awesome-blocklet

选项

  • --did string — 在创建过程中为 Blocklet 预先分配一个特定的去中心化标识符 (DID)。
  • --did-only boolean — 一种特殊的实用工具模式。此标志不会创建项目。相反，它会连接到您的 DID 钱包，以生成并显示一个适用于 Blocklet 的新 DID。这对于提前创建 DID 非常有用。

仅生成 Blocklet DID

如果您只需要为未来的 Blocklet 创建一个 DID 而无需启动新项目，请使用 --did-only 标志。

生成 DID

bash
blocklet create --did-only

此命令将连接到您的钱包，生成一个别名为 'blocklet' 的新 DID，并将结果打印到您的控制台。

输出示例

text
Created Blocklet DID: z2...A9

故障排除

偶尔，与 npx（Node.js 包运行器）相关的问题（例如缓存过时）可能会导致 create 命令失败。如果遇到错误，这里有几种解决方法。

1. 直接运行 create-blocklet

您可以绕过 blocklet create 包装器，直接使用 npx 执行 create-blocklet：

直接执行 npx

bash
npx create-blocklet@latest my-new-blocklet

2. 全局安装

或者，您可以在系统上全局安装 create-blocklet，然后运行它。

全局安装

bash
# 第 1 步：全局安装
npm install -g create-blocklet

# 第 2 步：运行命令
create-blocklet my-new-blocklet

创建项目后，下一步是在本地开发环境中运行它。有关更多信息，请继续阅读开发模式指南。