Blocklet のバンドルに成功したら、配布の次のステップは Blocklet Store にアップロードすることです。blocklet upload コマンドは、Blocklet バンドルを指定されたストアに送信し、他の人が見つけてインストールできるようにします。これは、公開配布の主要な方法です。
続行する前に、Blocklet がバンドル済みで、CLI がストアに接続するように設定されていることを確認してください。
コマンドの使用法
このコマンドは、デフォルトのリリースディレクトリにある Blocklet バンドルをアップロードします。
Basic Usage
blocklet upload [metaFile]引数とオプション
| 引数/オプション | 説明 |
|---|---|
metaFile | オプション。バンドルされた Blocklet の blocklet.json ファイルへのパス。指定しない場合、デフォルトは ./.blocklet/release/blocklet.json です。 |
--access-token <token> | オプション。Blocklet Store のアクセストークン。このフラグは、設定プロファイルで設定されているトークンを上書きします。 |
--profile <name> | オプション。使用する設定プロファイルを指定します。複数のストア接続 (例: 開発、ステージング、本番) を管理する場合に便利です。デフォルトは default です。 |
アップロードのワークフロー
アップロードプロセスでは、CLI がローカル設定と Blocklet バンドルを読み取り、検証と保存のために Blocklet Store に安全に送信します。
例
標準アップロード
プロジェクトのルートディレクトリにいて、デフォルトのプロファイルを設定している場合は、引数なしでコマンドを実行するだけです。
Upload from Project Root
blocklet upload特定のファイルのアップロード
特定の場所から Blocklet バンドルをアップロードするには、その blocklet.json ファイルへのパスを指定します。
Upload a specific bundle
blocklet upload /path/to/my-blocklet/.blocklet/release/blocklet.json別のプロファイルの使用
複数のストア設定がある場合は、--profile フラグを使用してアップロードに使用するものを指定します。
Upload using a profile
blocklet upload --profile productionアクセストークンの上書き
コマンドラインで直接アクセストークンを提供できます。これは CI/CD 環境で便利です。
Upload with a specific token
blocklet upload --access-token bst_xxxxxxxxxxxxxxxxxxxxxxアップロードの成功
アップロードが成功すると、確認メッセージが表示されます。正確なメッセージはストアの設定によって異なります。
アップロード済み (手動公開が必要)
最も一般的なのは、Blocklet がアップロードされ、開発者ダッシュボードからの手動公開を待つケースです。
Example Output: Uploaded
ℹ Blocklet My Awesome Blocklet 1.0.0 は https://store.blocklet.dev に正常にアップロードされました!
ℹ ヒント: Blocklet を公開するには https://store.blocklet.dev/developer/blocklets で公開する必要があります自動公開
場合によっては、ストアが新しいアップロードを自動的に公開するように設定されていることがあります。
Example Output: Auto-Published
✔ Blocklet My Awesome Blocklet 1.0.0 は正常に自動公開されました: https://store.blocklet.dev/blocklets/z8iZ......... !トラブルシューティング
無効なメタファイル
エラー: `Invalid meta file: '...'`。これは、コマンドが `blocklet.json` ファイルを見つけられないことを意味します。最初に `blocklet bundle` を実行し、正しいディレクトリにいることを確認してください。
ストア URL がありません
エラー: `Can not find the store url...`。CLI プロファイルにストアのアドレスがありません。`blocklet config set store [storeUrl]` を実行して修正してください。
アクセストークンエラー
エラー: `accessToken is required...` または `[NO-ACCESS]`。これは認証の失敗を示します。アクセストークンがない、無効、または期限切れです。`blocklet config set accessToken [token]` を使用してグローバルに設定するか、`--access-token` フラグを使用して単一のコマンドに渡すことができます。