资讯中心

如何用App Center CLI 3步把应用推送给测试者?Distribute发布完全教程

📅 2026/8/22 15:34:34
如何用App Center CLI 3步把应用推送给测试者?Distribute发布完全教程
如何用App Center CLI 3步把应用推送给测试者Distribute发布完全教程【免费下载链接】appcenter-cliCommand-line Interface (CLI) for Visual Studio App Center项目地址: https://gitcode.com/gh_mirrors/ap/appcenter-cliApp Center CLI 是微软为 Visual Studio App Center 打造的命令行工具其中的Distribute 功能可以把应用安装包一键推送给测试者、测试组或应用商店是移动开发者做测试分发的利器。本文带你用3 步完成一次完整的 App 分发发布即使零命令行基础也能快速上手。一、Distribute 分发功能能做什么在开始之前先了解 App Center CLI 的 Distribute 命令家族源码位于src/commands/distribute/目录。它覆盖了一个完整的分发生命周期能力说明创建/管理分发组按内部测试组、Beta 用户组等维度组织测试者上传并发布安装包一条命令完成上传 通知自动处理进度与校验管理已发布版本查看、编辑、追加分发目标、删除历史版本发布到外部商店将.aab/.apk/.ipa推送到已配置的应用商店 核心设计--group分组与 --store商店至少指定其一二者可组合使用这是 Distribute 发布的唯一硬性约束。二、准备工作安装 App Center CLI 并登录一键安装步骤要求 Node.js 18 或更高版本一条命令全局安装npm install --locationglobal appcenter-cli最快登录方法执行appcenter login会自动打开浏览器完成身份验证登录逻辑见src/commands/login.ts。在无浏览器的 CI 环境中可通过--token参数或环境变量传入 API 令牌。登录成功后用这条命令确认身份appcenter profile list三、第 1 步创建分发组并添加测试者发布前先建一个收件人组。groups create命令源码src/commands/distribute/groups/create.ts支持两种添加方式-t直接跟空格分隔的邮箱列表-T指向一个包含邮箱的文本文件适合大批量测试者appcenter distribute groups create \ -n Beta Testers \ -t aliceexample.com bobexample.com执行后终端会依次显示创建分组中…、添加测试者中…成功后输出类似Successfully created the Beta Testers distribution group with 2 testers的确认信息。 想随时查看有哪些分组和人数运行appcenter distribute groups list该命令src/commands/distribute/groups/list.ts会并发拉取各分组人数以组名 用户数的表格呈现限流 10 并发分组再多也不慢。四、第 2 步一条命令上传并推送发布这是整个流程的灵魂命令核心实现src/commands/distribute/release.ts。它会在后台自动完成6 个阶段校验参数文件存在、版本号齐全等创建上传会话上传安装包显示进度上传发布说明推送给分发组或商店回查发布状态并打印结果appcenter distribute release \ -f ./build/app.ipa \ -g Beta Testers \ -r 修复了闪退问题欢迎体验新版本常用参数速查参数说明-f, --file安装包路径必填-g, --group目标分组逗号分隔可指定多个-s, --store目标商店名称-r, --release-notes发布说明文本最多 5000 字符-R, --release-notes-file从 Markdown 文件读取发布说明--mandatory标记为强制更新测试者必须升级--silent静默发布不向测试者发通知-b, --build-version.zip/.msi/.pkg/.dmg包必填-n, --build-numbermacOS.pkg/.dmg包必填-t, --timeout等待发布就绪的超时秒数⚠️新手避坑清单来自源码中的参数校验逻辑-r与-R互斥只能二选一发 Apple 商店时必须带发布说明-r或-R商店分发仅支持.aab、.apk、.ipa三种格式同时指定-g和-s时若商店发布失败但分组已推送会明确提示分组部分已成功避免重复操作。五、第 3 步确认发布结果发布完成后验证是否真的推送成功appcenter distribute releases list列表会展示版本 ID、短版本号、构建号与上传时间实现src/commands/distribute/releases/list.ts。再查看详情appcenter distribute releases show -r 发布IDshow命令src/commands/distribute/releases/show.ts会输出完整报告版本状态、大小、最低系统要求、下载/安装链接以及Destinations分发目标列表——测试者邮箱和分组名都会列在这里一眼确认分发去向。六、进阶技巧发布后还能追加分发目标已经发布的版本漏了某个测试者不用重新上传releases add-destination命令src/commands/distribute/releases/add-destination.ts可以把现有发布追加到新的目标appcenter distribute releases add-destination \ -r 42 -t tester -d carolexample.com目标类型支持三种store商店、group分组、tester单个测试者邮箱同样支持--mandatory与--silent。另外两条实用命令编辑发布说明appcenter distribute releases edit-notes——发现说明写错了直接改不用重新发版启用/停用发布appcenter distribute releases edit——紧急情况下一键停发。七、上手检查清单 ✅已安装 Node.js 18 并全局安装 appcenter-cliappcenter login登录成功profile list显示你的账号已创建分发组并添加测试者邮箱执行distribute release完成上传与推送用releases show核对了分发目标与版本信息掌握以上 3 步你就已经用 App Center CLI 完成了从安装包到测试者手机的完整 Distribute 发布闭环。更多命令参数细节可直接运行appcenter help distribute查看全部帮助或参阅 README.md 中的完整命令表。【免费下载链接】appcenter-cliCommand-line Interface (CLI) for Visual Studio App Center项目地址: https://gitcode.com/gh_mirrors/ap/appcenter-cli创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考