蒲公英文档中心

版本管理

在 Dashboard V2 中管理 App 版本,了解账户共享容量、超额处理策略与历史版本清理规则。

选择目标 App 后点击顶部 版本,即可管理该 App 当前保留的版本。部分批量操作和定时发布能力会根据账户方案与权限显示。

截至 2026 年 9 月 18 日,存储规则已调整为按账户容量管理,旧的按每个 App 版本数量自动清理规则已暂停。目前容量超额仅提示,网页、客户端及 API 仍可上传,不会因容量超额自动清理安装包。计划自 2026 年 10 月 15 日起启用下述超额处理,具体以平台公告和页面提示为准。

账户容量与使用情况

同一主账户下的 App 与历史版本共享存储容量,子账号上传的 App 也计入主账户,不再分别按每个 App 的版本个数判断是否超额。常见账户的基础容量如下:

账户情况基础容量
未完成实名认证,或个人认证且无有效付费套餐20 GiB
企业认证,无有效付费套餐30 GiB
已认证,普通付费套餐仍在有效期内50 GiB

容量按安装包空间计算,1 GiB = 1024 MiB。套餐、已购空间包和账户专属权益可能影响总额度,请以 账户菜单 → 使用情况 显示的总额度和已用容量为准。实名认证、每日发布次数等上传要求仍单独适用。

使用情况 中,您可以查看最新版本与历史版本的空间分布、按 App 查看用量并手动清理;也可以通过 增加空间 购买空间包。操作方法见 账户中心

正式启用后的超额处理

主账户可在 使用情况 → 超额处理 中选择策略。未修改过策略的账户默认使用第一项,无需先点击保存;更改选项后点击 保存策略 即可。

策略处理方式
先清理当前 App 的历史版本,不足时继续清理其他 App 的历史版本(默认)优先清理本次上传 App 中符合条件的较早历史版本;仍超额时,继续按上传先后顺序清理账户内其他 App 的合格历史版本
仅清理当前 App 的历史版本仅在本次上传 App 内清理合格历史版本,不清理其他 App;仍超额时,需要手动清理或增加空间
阻止新上传,由我手动清理超额时不执行容量自动清理,需要先手动清理或增加空间,再重新上传

自动清理针对符合条件的历史版本,不会删除整个 App。容量清理会保护系统最新版本、当前对外版本和渠道引用等受保护版本;不是所有历史版本都能自动清理。

上传时如何判断

以下行为在容量规则正式启用后适用:

  • 开始上传时未超额或刚好用满:允许本次上传,不提前为即将上传的安装包预留空间。发布成功后若超额,按账户策略处理;手动清理策略下,本次发布可完成,后续新上传会受影响。
  • 开始上传时已经超额:选择自动清理策略时,先按策略尝试清理已有超额,恢复至额度内后继续;若可清理的历史版本不足,仍会提示容量不足。选择手动清理策略时,直接提示先处理空间。
  • 旧客户端或 API 暂未提供目标 App:可能先接收安装包,识别所属 App 后再检查和清理。文件传输完成不等于发布成功,应继续检查最终发布结果。

自动策略会持续尝试清理,直到回到容量额度内,或没有可清理的版本。清理量较大时可能需要分批完成;若页面或 API 提示正在清理,请稍后重试。选择自动清理不代表任何情况下都能上传成功。

网页上传无法继续时,会显示原因及处理提示;API 返回失败结果和错误信息,调用方应检查 codemessage 及最终发布状态。子账号遇到空间不足时,请联系主账户管理员清理历史版本或增加空间。

正式启用后,容量自动清理按账户策略执行,不会在每次上传时再次要求确认。请提前备份仍需长期归档的安装包;删除后的历史版本无法恢复。

最新版本与历史版本

正常托管的 App,其系统最新版本长期保留,不会因容量超额或连续无下载而自动清理。发布新版后,原最新版成为历史版本;是否可清理还取决于版本状态和引用情况。您主动删除 App、删除版本或应用被封禁等情况不属于最新版本保护范围。

应用下载有效期与版本保留是不同概念。下载设置中的“长期有效”表示没有设置下载起止时间,不代表每个历史安装包永久保存。平台自动到期与手动续签机制已取消;其他下载限制参见 应用有效期与下载可用性

长期不活跃历史版本

长期不活跃历史版本的清理规则独立运行,不因容量超额处理尚未启用或购买空间包而暂停。非最新版本连续 90 天没有生成下载地址,可能进入清理流程;从未生成过下载地址的版本,从上传创建时间计算。下载地址生成记录只是活跃度参考,不等同于安装包已经完整下载。

如版本进入宽限期,请以 Dashboard 版本 列表中的 宽限期至 和站内通知为准,在截止日期前备份。到期后系统会再次核查条件,符合条件的版本进入 待清理 并分批处理。通知可能按账户合并,未收到或未阅读通知不会自动延长截止日期。

筛选与批量操作

列表可按 全部、已显示、已隐藏 筛选。选择版本后,页面可能提供:

  • 批量显示、隐藏或删除一个或多个版本;
  • 只选择一个版本时,将其设为当前版本;
  • 账户已开通对应能力时,批量设为 Dev 或 Pro 环境。

单个版本操作

每个版本可执行的操作包括:

操作说明
编辑修改版本更新说明等可编辑信息
发布立即发布,或在账户支持时设置定时发布
显示/隐藏控制该版本是否出现在安装页面
设为当前版本将该版本作为 App 当前对外版本
设为 Dev/Pro在账户已开通对应能力时切换版本环境
二维码与链接获取该版本对应的安装入口
下载下载已上传的安装包
证书查看该安装包的签名与设备信息
删除永久移除该版本及其安装包

设置当前版本时只能选择一个版本。删除版本不可恢复;执行批量删除前,请确认仍保留至少一个业务需要的版本,并检查外部渠道是否仍指向待删除版本。

渠道可拥有多个版本且顺序独立。版本发布或删除后,请同时检查 分发渠道设置 中的版本列表。

本页目录