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

プロジェクトの作成

blocklet create コマンドは、新しい Blocklet プロジェクトを始めるための最速の方法です。これは create-blocklet という対話型のスキャフォールディングツールを使用しており、さまざまな公式スターターテンプレートから選択できます。このコマンドは、新しいアプリケーションをブートストラップするための推奨される方法です。

使用方法

このコマンドは npx create-blocklet@latest の便利なラッパーとして機能します。

Command

bash
blocklet create [name] [options]

引数

  • [name] string — 新しい blocklet プロジェクトの名前。名前を省略した場合、対話型のセットアッププロセスで入力を求められます。

仕組み

blocklet create を実行すると、セットアッププロセスをガイドする対話型のコマンドラインインターフェースが開始されます。以下のプロンプトが表示されます:

  1. blocklet の名前を入力します(引数として提供されていない場合)。
  2. スターターテンプレート(例:React、Vue、Static など)を選択します。

その後、ツールは指定された名前で新しいディレクトリを作成し、テンプレートをダウンロードし、必要な依存関係をインストールします。

対話型セッションを開始するには、引数を付けずにコマンドを実行するだけです:

Interactive Mode

bash
blocklet create

すでに名前を決めている場合は、直接指定できます:

Direct Mode

bash
blocklet create my-awesome-blocklet

オプション

  • --did string — 作成時に特定の分散型識別子(DID)を blocklet に事前に割り当てます。
  • --did-only boolean — 特殊なユーティリティモードです。このフラグはプロジェクトを作成しません。代わりに、DID ウォレットに接続して、blocklet に適した新しい DID を生成して表示します。これは、事前に DID を作成するのに役立ちます。

Blocklet DID のみの生成

新しいプロジェクトを開始せずに、将来の blocklet 用に DID を作成するだけの場合は、--did-only フラグを使用します。

Generate DID

bash
blocklet create --did-only

このコマンドはウォレットに接続し、「blocklet」というモニカで新しい DID を生成し、その結果をコンソールに出力します。

Example Output

text
Created Blocklet DID: z2...A9

トラブルシューティング

時々、npx(Node.js パッケージランナー)に関連する問題、例えば古いキャッシュなどが原因で create コマンドが失敗することがあります。エラーが発生した場合は、いくつかの回避策があります。

1. create-blocklet を直接実行する

blocklet create ラッパーをバイパスして、npx を使用して create-blocklet を直接実行できます:

Direct npx Execution

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

2. グローバルにインストールする

または、システムに create-blocklet をグローバルにインストールしてから実行することもできます。

Global Installation

bash
# ステップ 1: グローバルにインストール
npm install -g create-blocklet

# ステップ 2: コマンドを実行
create-blocklet my-new-blocklet

プロジェクトを作成したら、次のステップはローカル開発環境で実行することです。詳細については、開発モード ガイドに進んでください。