发布版本与设置下载页
本页内容
查看当前发布版本、切换保留的历史版本,并设置下载页面的模板、语言和介绍。面向安装用户的下载页面可免登录访问,管理接口需要单独授权。
了解发布与取包
发布版本决定公开下载页当前使用的安装包;API 下载凭证用于程序取得某个明确版本。普通分发使用 package_type=original,不会通过这些接口自动生成企业签名包。
前提条件
已有校验成功的应用版本。读取版本、发布版本、修改下载设置和下载原包分别授权;公开下载页面免登录访问,不等于管理接口无需授权。
查看或切换版本
- 读取版本列表,确认目标版本与当前发布版本 ID。
- 让使用者确认要切换的版本,保存本次操作幂等键。
- 带回
version_id与刚读取的current_version_id。 - 重新读取列表,确认目标版本的
is_current。
Python SDK
def publish_distribution_version(client, app_id, target_version_id,
current_version_id, write_key, confirmed):
if confirmed is not True:
raise ValueError("请先确认当前版本与要发布的目标版本")
return client.publish_version(
app_id, target_version_id, current_version_id, write_key
)["data"]修改下载页面
读取模板、语言、纯文本介绍及 revision。变更模板或语言时,从响应返回的可选值中选择;只修改介绍时可保留原模板与语言。
Python SDK
def update_download_introduction(client, app_id, introduction, write_key):
current = client.get_distribution_settings(app_id)["data"]
return client.update_distribution_settings(
app_id, current["revision"], current["template_id"],
current["language"], introduction, write_key,
)["data"]填写介绍时使用普通文本,不发送 HTML。保存后重新打开平台配置的分发地址核对展示。
在服务端下载原包
确认准确版本 ID后申请短期凭证,在有效期内按返回的方式取包。下载链接包含授权信息,不打印到日志,也不通过改写 URL 猜测其他版本。
Python SDK
def request_original_download(client, app_id, version_id, write_key):
return client.create_download_ticket(
app_id, version_id, "original", 300, write_key
)["data"]
# 将短期地址交给下载代码;不要打印凭证或 Authorization。凭证过期或重放只得到 ticket=null 时,先确认是否仍需要取包,再明确申请新凭证。SDK 完整性下载助手还需要独立可信摘要与存储来源白名单。
确认结果与冲突处理
RevisionConflict 表示当前内容已变化,先读取并核对,不自动覆盖。上传、发布或页面设置失败时,按原应用及版本查询结果;一次更新超时后不换应用 ID 重复上传。