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

发布版本与设置下载页

本页内容

查看当前发布版本、切换保留的历史版本,并设置下载页面的模板、语言和介绍。面向安装用户的下载页面可免登录访问,管理接口需要单独授权。

了解发布与取包

发布版本决定公开下载页当前使用的安装包;API 下载凭证用于程序取得某个明确版本。普通分发使用 package_type=original,不会通过这些接口自动生成企业签名包。

前提条件

已有校验成功的应用版本。读取版本、发布版本、修改下载设置和下载原包分别授权;公开下载页面免登录访问,不等于管理接口无需授权。

查看或切换版本

  1. 读取版本列表,确认目标版本与当前发布版本 ID。
  2. 让使用者确认要切换的版本,保存本次操作幂等键。
  3. 带回 version_id 与刚读取的 current_version_id。
  4. 重新读取列表,确认目标版本的 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 重复上传。