注释
本页介绍使用 Microsoft 应用商店开发人员 CLI 发布的 MSI/EXE 应用。 有关使用 Microsoft 应用商店开发人员 CLI 发布 MSIX 应用的信息, 请单击此处。
Microsoft Store命令行接口是一个跨平台(Windows、macOS、Linux)CLI,可帮助你将更新发布到Microsoft Store中的应用程序。 对于 MSI/EXE 应用,CLI 调用 Partner Center APIs 来提交包含开发人员托管安装程序 URL 的包元数据。 应用商店从该 URL 检索安装程序;CLI 不打包或上传安装程序二进制文件。 有关托管要求,请参阅 添加和编辑包信息。
重要
必须通过合作伙伴中心完成你的应用在 Microsoft Store 的首次发布。 发布应用后,可以使用Microsoft Store开发人员 CLI 发布后续更新。
对于 MSI/EXE 和 MSIX 应用,使用应用商店开发人员 CLI 的过程是相同的。 因此,若要了解如何使用它,请查看以下视频:
先决条件
若要使用 Microsoft 应用商店开发人员 CLI,需要:
- 在合作伙伴中心注册为 Windows 应用开发人员
- 确保合作伙伴中心帐户有关联的租户。 可以通过在 合作伙伴中心关联现有Microsoft Entra ID 或在 合作伙伴中心创建新的Microsoft Entra ID 来实现此目的。
- 确保已在合作伙伴中心创建应用。 如果你的应用尚不存在,请在 Partner Center 中通过预留应用名称来创建应用。 CLI 无法为你创建应用。
- 通过合作伙伴中心完成应用的首次发布。 为应用创建第一个提交,包括 年龄分级 问卷,并在合作伙伴中心提交以进行认证。 在使用 CLI 发布后续更新之前,请等待应用发布到Microsoft Store。
Installation
Microsoft应用商店开发人员 CLI 支持 Windows 10+、Linux 和 macOS:
立即安装Microsoft应用商店开发人员 CLI(预览版!
入门
安装 Microsoft 应用商店开发人员 CLI 后,必须将环境配置为能够运行命令。 只需首次运行 CLI 即可执行此操作。 CLI 将指导你完成配置过程:
msstore
还支持在 CI 环境中运行,Microsoft Store 开发人员 CLI(预览版)可用于 CI/CD 管道,例如在 Microsoft Store 中自动发布应用更新。 有关如何执行此作的更多说明,可 在此处找到。
注释
仅免费产品支持通过 Microsoft 应用商店开发人员 CLI 进行应用更新操作。 未来版本将支持付费产品。
指令
以下是 Microsoft Store 开发人员 CLI 可用的命令:
| Command | Description |
|---|---|
| 信息 | 打印现有配置。 |
| 重新配置 | 重新配置Microsoft应用商店开发人员 CLI。 |
| 设置 | 更改 Microsoft 应用商店开发人员 CLI 的设置。 |
| 提交 | 提交相关的命令,如“status”、“get”、“getListingAssets”、“updateMetadata”、“update”、“poll”、“publish”。 |
有关详细信息,请参阅: 命令。
常见问题解答
什么是Microsoft Store开发人员 CLI 以及如何帮助我?
Microsoft应用商店开发人员 CLI 是一种跨平台命令行工具,可让开发人员自动执行许多合作伙伴中心任务,例如:
- 列出和获取应用程序信息
- 更新包元数据,包括开发人员托管安装程序的 URL
- 更新应用商店元数据
- 提交和发布应用更新
此工具特别适用于 CI/CD 管道,可在应用首次发布后通过合作伙伴中心自动提交更新的安装程序 URL 并发布应用更新。 身份验证是使用链接到合作伙伴中心帐户的 Entra ID 凭据完成的。
它提供了一种灵活的 Web UI 替代方案,并支持在 Windows、macOS 和 Linux 上进行脚本编写工作流。 若要使用它,开发人员必须首先配置具有适当权限的 API 访问权限。 借助此工具,团队可以显著简化和扩大其发布操作。
我可以使用 CLI 自动化应用商店提交流程吗?
是的,通过合作伙伴中心完成应用的第一次发布后,可以在生成管道中使用 CLI 提交更新的包元数据并发布后续应用更新。 单独生成并托管 MSI/EXE 安装程序,然后使用 CLI 提交包含其 URL 的包元数据。 应用商店从该 URL 检索安装程序;CLI 不打包或上传它。 您无法使用 CLI 完成首次发布。