跳转到主要内容
1签 (OneSign)

管理版本与下载签名包

本页内容

原包和签名包分别有自己的版本 ID。本指南说明如何查找版本、申请下载凭证,以及将应用切换到保留的历史签名版本。

区分原包和签名包

包类型来源主要用途
original 原包上传 IPA 并校验成功后保存签名输入、原始文件归档
signed 签名包签名任务成功后生成下载签名结果、发布或回滚

版本 ID 表示一个具体版本。应用 ID 不能代替版本 ID,原包版本也不能代替签名包版本。

前提条件

已取得自己的应用 ID。读取版本使用 enterprise:ReadVersions;下载原包与签名包分别需要 enterprise:DownloadOriginal 和 enterprise:DownloadSigned。切换历史版本需要 enterprise:PublishVersions,并满足对应功能的接入条件。

查找所需版本

查某次签名结果时,优先使用 查询签名任务对应的准确产物返回的 signed_version.id。浏览历史记录时,可按包类型调用 列出应用历史版本:

Python SDK
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 表示当前发布版本,不表示它一定属于您正在查询的签名任务。

下载指定安装包

  1. 确认应用、完整版本 ID和包类型。
  2. 为本次申请保存幂等键,调用 申请安装包下载凭证。
  3. 在凭证有效期内,按 ticket 返回的方法、地址和请求头传输文件。
  4. 核对下载大小;使用 SDK 完整性校验助手时,还需从独立可信来源提供预期 SHA-256。
Python SDK
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 自动推导信任白名单。

切换历史签名版本

  1. 读取当前发布版本 ID,选择要切换到的历史签名版本。
  2. 向使用者展示当前版本和目标版本,取得确认。
  3. 提交目标 version_id 和刚读取的 current_version_id。
  4. 重新查询版本列表,确认目标版本的 is_current。
Python SDK
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 或结果已清理核对版本及文件是否仍存在。不能改为下载另一个任务的“最新包”来冒充本次结果。
文件大小或可信摘要不匹配停止使用该文件,核对目标版本和传输结果,不跳过完整性检查。

相关接口