備註
本頁介紹使用 Microsoft Store 開發者 CLI 進行 MSI/EXE 應用程式發佈。 如需使用 Microsoft Store 開發人員 CLI 發佈 MSIX 應用程式的資訊,請按兩下 這裡。
Microsoft Store 命令列介面是一個跨平台(Windows、macOS、Linux)的 CLI,幫助你在 Microsoft Store 發佈應用程式更新。 對於 MSI/EXE 應用程式,CLI 會呼叫合作夥伴中心 API ,提交包含開發者安裝程式 URL 的套件元資料。 商店會從該網址取得安裝程式;CLI 不會打包或上傳安裝檔二進位檔。 關於託管需求,請參閱 新增與編輯套件資訊。
這很重要
您必須透過合作夥伴中心完成應用程式的首次發佈至 Microsoft Store。 應用程式發佈後,您可以使用 Microsoft Store 開發者 CLI 發布後續更新。
使用 Store Developer CLI 的過程對於 MSI/EXE 和 MSIX 應用程式都是相同的。 因此,要了解如何使用它,請觀看以下視頻:
先決條件
若要使用 Microsoft Store 開發人員 CLI,您必須:
- 在合作夥伴中心註冊為 Windows 應用程式開發人員
- 將租用戶與您的 Partner Center 帳戶建立關聯。 您可以在 合作夥伴中心關聯現有的 Microsoft Entra 標識碼 ,或 在合作夥伴中心建立新的 Microsoft Entra 標識碼來達成此目的。
- 請先在合作夥伴中心建立你的應用程式。 如果你的應用程式尚未建立,請在合作夥伴中心保留其名稱來建立應用程式。 CLI 無法幫你建立應用程式。
- 請透過合作夥伴中心完成應用程式的首次發佈。 為應用程式製作第一份提交,包括 年齡評分 問卷,並提交至合作夥伴中心進行認證。 請等應用程式發佈到 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 進行應用程式更新操作。 付費產品將在未來版本中提供支援。
Commands
以下是 Microsoft Store 開發人員 CLI 可用的命令:
| Command | Description |
|---|---|
| 資訊 | 列印現有的組態。 |
| 重新配置 | 重新設定 Microsoft Store 開發人員 CLI。 |
| 設定 | 變更 Microsoft Store 開發人員 CLI 的設定。 |
| 提交 | 提交相關命令,例如 'status'、'get'、'getListingAssets'、'updateMetadata'、'update'、'poll'、'publish'。 |
如需詳細資訊,請參閱: 命令。
常見問題
什麼是 Microsoft Store 開發者 CLI?它能如何幫助我?
Microsoft Store 開發人員 CLI 是跨平臺命令列工具,可讓開發人員將許多合作夥伴中心工作自動化,例如:
- 列出和檢索應用程式資訊
- 更新套件的元資料,包括你開發者主機安裝程式的網址
- 更新商店中繼資料
- 提交和發佈應用程式更新
此工具特別適合 CI/CD 流程,在其中可自動提交更新的安裝 URL,並在應用程式首次發佈後透過 Partner Center 發布應用程式更新。 驗證是使用連結至合作夥伴中心帳戶的 Entra ID 認證來完成。
它提供了 Web UI 的靈活替代方案,並支持跨 Windows、macOS 和 Linux 的腳本工作流程。 要使用它,開發人員必須先配置具有適當權限的 API 存取權限。 借助此工具,團隊可以顯著簡化和擴展其發布操作。
我可以用 CLI 自動化商店提交嗎?
是的,當你透過合作夥伴中心完成應用程式的首次發佈後,你可以在建置流程中使用 CLI 提交更新的套件元資料並發布後續的應用程式更新。 先分別建置並架設你的 MSI/EXE 安裝程式,然後用 CLI 提交包含其 URL 的套件元資料。 商店會從該網址取得安裝程式;CLI 不會打包或上傳。 你不能用 CLI 來完成首次發佈。