成功捆綁您的 blocklet 後，分發的下一步是將其上傳到 Blocklet 商店。blocklet upload 指令會將您的 blocklet 捆綁包發送到指定的商店，使其可供他人發現和安裝。這是公開分發的主要方法。
在繼續之前，請確保您已經捆綁了您的 blocklet 並配置了您的 CLI 以連接到商店。
指令用法
該指令會上傳在預設發布目錄中找到的 blocklet 捆綁包。
Basic Usage
blocklet upload [metaFile]參數與選項
| 參數/選項 | 說明 |
|---|---|
metaFile | 可選。已捆綁的 blocklet 的 blocklet.json 檔案路徑。如果未指定，則預設為 ./.blocklet/release/blocklet.json。 |
--access-token <token> | 可選。Blocklet 商店的存取權杖。此旗標會覆蓋您設定檔中設定的任何權杖。 |
--profile <name> | 可選。指定要使用的設定檔。當您管理多個商店連接（例如，開發、預備、生產）時，這非常有用。預設為 default。 |
上傳工作流程
上傳過程包括 CLI 讀取您的本地設定和 blocklet 捆綁包，然後將其安全地傳輸到 Blocklet 商店進行驗證和儲存。
範例
標準上傳
如果您位於專案的根目錄中，並且已配置了預設設定檔，只需執行不帶任何參數的指令即可。
從專案根目錄上傳
blocklet upload上傳特定檔案
要從特定位置上傳 blocklet 捆綁包，請提供其 blocklet.json 檔案的路徑。
上傳特定的捆綁包
blocklet upload /path/to/my-blocklet/.blocklet/release/blocklet.json使用不同的設定檔
如果您有多個商店設定，請使用 --profile 旗標指定要用於上傳的設定。
使用設定檔上傳
blocklet upload --profile production覆蓋存取權杖
您可以直接在命令列中提供存取權杖，這對於 CI/CD 環境非常有用。
使用特定的權杖上傳
blocklet upload --access-token bst_xxxxxxxxxxxxxxxxxxxxxx成功上傳
成功上傳後，您將看到一條確認訊息。具體訊息取決於商店的設定。
已上傳（需手動發布）
最常見的情況是，blocklet 已上傳並等待從開發者儀表板手動發布。
範例輸出：已上傳
ℹ Blocklet My Awesome Blocklet 1.0.0 已成功上傳至 https://store.blocklet.dev!
ℹ 提示：您需要在 https://store.blocklet.dev/developer/blocklets 發布 blocklet，使其可公開存取自動發布
在某些情況下，商店可能會設定為自動發布新的上傳。
範例輸出：自動發布
✔ 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` 旗標為單個指令傳遞它。