備註
本頁介紹使用 Microsoft Store 開發者 CLI 進行 MSIX 應用程式發佈。 如需使用 Microsoft Store 開發人員 CLI 發佈 MSI/EXE 應用程式的資訊,請按一下 這裡。
Microsoft Store 命令列介面是一個跨平台(Windows、macOS、Linux)的 CLI,幫助你在 Microsoft Store 發佈應用程式更新。 你可以在本地設定應用程式專案,並透過 CLI 發布更新的套件,CLI 會呼叫 Partner Center API 來上傳套件。
重要
您必須透過合作夥伴中心完成應用程式的首次發佈至 Microsoft Store。 應用程式發佈後,您可以使用 Microsoft Store 開發者 CLI 發布後續更新。
若要瞭解如何使用市集開發人員CLI,請檢視下列影片:
必要條件
若要使用 Microsoft Store 開發人員 CLI,您必須:
- 在合作夥伴中心註冊為 Windows 應用程式開發人員
- 將租用戶與您的合作夥伴中心帳戶相關聯。 您可以在 合作夥伴中心關聯現有的 Microsoft Entra 標識碼 ,或 在合作夥伴中心建立新的 Microsoft Entra 標識碼來達成此目的。
- 請先在合作夥伴中心建立你的應用程式。 如果您的應用程式尚未建立,請在合作夥伴中心先預留其名稱來建立應用程式。 CLI 無法幫你建立應用程式。
- 請透過合作夥伴中心完成應用程式的首次發佈。 為應用程式製作第一份提交,包括 年齡評分 問卷,並提交至 Partner Center 進行認證。 請等應用程式發佈到 Microsoft Store 後,再使用 CLI 發布後續更新。
安裝
Microsoft Store 開發人員 CLI 支援 Windows 10+、Linux 和 macOS:
立即安裝 Microsoft 市集開發人員 CLI (預覽版) !
使用者入門
安裝 Microsoft Store 開發人員 CLI 之後,您必須設定環境才能執行命令。 您只要首次執行 CLI,即可完成此操作。 CLI 將引導您完成設定流程:
msstore
重要
請勿使用您的 MSA 來登入! Microsoft Store 開發人員 CLI 要求您使用 Microsoft Entra ID 認證。 您可以在 必要條件一 節中找到此項目的詳細資訊。
也支援在 CI 環境中執行,並且 Microsoft Store 開發者 CLI(預覽版)可用於您的 CI/CD 流程中,例如自動發佈您在 Microsoft Store 中的應用程式更新。 如需有關如何執行這項操作的更多指示,請參閱這裡。
備註
目前僅支援免費產品,透過 Microsoft Store 開發者 CLI 進行應用程式更新操作。 付費產品將在未來版本中提供支援。
命令
以下是 Microsoft Store 開發人員 CLI 可用的命令:
| 指令 | 描述 |
|---|---|
| 資訊 | 列印現有的組態。 |
| 重新配置 | 重新設定 Microsoft Store 開發人員 CLI。 |
| 設置 | 變更 Microsoft Store 開發人員 CLI 的設定。 |
| 應用程式 | 與應用程式相關的命令,例如在您的帳戶中列出應用程式,以及擷取應用程式的詳細資料。 |
| 提交 | 與提交作業相關的指令,例如「status」、「get」、「getListingAssets」、「updateMetadata」、「update」、「poll」、「publish」、「delete」、「rollout」。 |
| init | 協助您設定應用程式以發佈至 Microsoft Store。 |
| 套件 | 協助您將 Microsoft Store 應用程式封裝為 MSIX。 |
| 發佈 | 在 Microsoft Store 發佈您應用程式的更新。 |
| 飛行 | 飛行相關指令,如「列出」、「取得」、「刪除」、「建立」、「提交」。 |
如需詳細資訊,請參閱: 命令。
常見問題
什麼是 Microsoft Store 開發者 CLI?它能如何幫助我?
Microsoft Store 開發人員 CLI 是跨平臺命令列工具,可讓開發人員將許多合作夥伴中心工作自動化,例如:
- 列出和檢索應用程式資訊
- 上傳新套件
- 更新商店中繼資料
- 提交和發佈應用程式更新
此工具特別適用於 CI/CD 流程,因為新建置可在應用程式首次發佈後,透過 Partner Center 自動提交並發布為更新。 驗證是使用連結至合作夥伴中心帳戶的 Entra ID 認證來完成。
它提供了 Web UI 的靈活替代方案,並支持跨 Windows、macOS 和 Linux 的腳本工作流程。 要使用它,開發人員必須先配置具有適當權限的 API 存取權限。 借助此工具,團隊可以顯著簡化和擴展其發布操作。
我可以用 CLI 自動化商店提交嗎?
是的,當你透過合作夥伴中心完成應用程式的首次發佈後,你可以在建置流程中使用 CLI,自動化打包、提交作業及後續應用程式更新的發布。 你不能用 CLI 來完成首次發佈。