管理版本与下载签名包
本页内容
原包和签名包分别有自己的版本 ID。本指南说明如何查找版本、申请下载凭证,以及将应用切换到保留的历史签名版本。
区分原包和签名包
| 包类型 | 来源 | 主要用途 |
|---|---|---|
original 原包 | 上传 IPA 并校验成功后保存 | 签名输入、原始文件归档 |
signed 签名包 | 签名任务成功后生成 | 下载签名结果、发布或回滚 |
版本 ID 表示一个具体版本。应用 ID 不能代替版本 ID,原包版本也不能代替签名包版本。
前提条件
已取得自己的应用 ID。读取版本使用 enterprise:ReadVersions;下载原包与签名包分别需要 enterprise:DownloadOriginal 和 enterprise:DownloadSigned。切换历史版本需要 enterprise:PublishVersions,并满足对应功能的接入条件。
查找所需版本
查某次签名结果时,优先使用 查询签名任务对应的准确产物返回的 signed_version.id。浏览历史记录时,可按包类型调用 列出应用历史版本:
def list_signed_versions(client, app_id, cursor=None):
return client.list_versions(
app_id, limit=50, cursor=cursor, package_type="signed"
)["data"]对选中的版本再调用 查询指定版本,核对名称、包类型、大小和发布状态。is_current 表示当前发布版本,不表示它一定属于您正在查询的签名任务。
下载指定安装包
- 确认应用、完整版本 ID和包类型。
- 为本次申请保存幂等键,调用 申请安装包下载凭证。
- 在凭证有效期内,按
ticket返回的方法、地址和请求头传输文件。 - 核对下载大小;使用 SDK 完整性校验助手时,还需从独立可信来源提供预期 SHA-256。
def request_signed_download(client, app_id, signed_version_id, write_key):
return client.create_download_ticket(
app_id, signed_version_id, "signed", 300, write_key
)["data"]
# 返回值含短期授权地址,交给实际下载代码,不打印到日志。申请原包时将 package_type 设为 original,并选择原包版本。凭证只对指定版本和包类型有效,不能修改 URL 来下载其他文件。
下载凭证中的 URL 含短期授权信息,不要写入公开日志。业务 API 的取包凭证与面向安装用户的分发下载页面用途不同;下载页可以免登录访问,业务 API 仍需授权。
使用命令行工具校验下载
enterprise_signing.py 的 --download 选项同时要求可信摘要 --sha256 和受信存储来源 --storage-origin。当前 API 提供文件大小和短期地址,不提供可信安装包 SHA-256。没有独立摘要时省略这个选项,按准确版本 ID 在自己的后端实现取包。不要从下载 URL 自动推导信任白名单。
切换历史签名版本
- 读取当前发布版本 ID,选择要切换到的历史签名版本。
- 向使用者展示当前版本和目标版本,取得确认。
- 提交目标
version_id和刚读取的current_version_id。 - 重新查询版本列表,确认目标版本的
is_current。
def publish_confirmed_version(client, app_id, target_version_id,
current_version_id, write_key, confirmed):
if confirmed is not True:
raise ValueError("请先确认要切换的应用和签名版本")
version = client.get_version(app_id, target_version_id)["data"]
if version["package_type"] != "signed":
raise ValueError("企业签名发布需要选择签名包版本")
return client.publish_version(
app_id, target_version_id, current_version_id, write_key
)["data"]企业签名只能切换到符合发布条件的已签名版本。发生 RevisionConflict 时,先核对是否有其他操作更新了当前版本。回滚发布不会重新签名,也不会延长签名服务或证书期限。
下载异常处理
| 问题 | 处理方式 |
|---|---|
| 凭证过期 | 确认仍需要下载该版本后,明确发起一次新的凭证申请,保存新的申请幂等键。 |
幂等重放返回 ticket=null | 旧响应只保留回执,不会再次交付下载地址。不要把空凭证作为可用链接。 |
PackageUnavailable 或结果已清理 | 核对版本及文件是否仍存在。不能改为下载另一个任务的“最新包”来冒充本次结果。 |
| 文件大小或可信摘要不匹配 | 停止使用该文件,核对目标版本和传输结果,不跳过完整性检查。 |