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

上传与更新分发安装包

本页内容

将 IPA 或 APK 上传为普通分发应用的新版本。上传传输完成后,还需要平台校验并保存版本;请以任务成功和版本 ID 为准。

选择上传方式

推荐直接调用 SDK 上传助手,提交应用 ID、文件和本次操作的幂等键即可。平台自动选择文件传输服务,SDK 自动申请上传凭证、切分文件并确认结果;业务代码无需判断存储厂商或填写后台存储配置。

上传助手使用通用分片流程,小文件只传一片,大文件按接口返回的大小分片。需要自行实现 HTTP 客户端时,按下表选择传输方式。

上传方式适用场景处理方式
分片上传(推荐)首次接入、小文件、大文件和断点续传。创建分片上传任务,按返回指令传输并确认。SDK 上传助手会自动完成这些步骤。
整包上传(可选)已有整包上传集成,且当前接口支持此方式。申请整包上传凭证并发送整个文件。若返回 StorageUnsupported,改用通用分片流程,无需识别底层存储。

一个上传任务对应一个安装包。可上传的大小以账号限额和接口返回值为准。创建成功后立即保存上传任务 ID,即响应中的 data.id。中断后保留原文件和幂等键,继续处理同一个上传任务。

Python 项目可使用可恢复上传助手;自行实现传输时,按本页顺序调用接口。

前提条件

准备目标普通分发应用 ID 和真实 IPA 或 APK,包名与平台一致。新应用先完成创建;更新时使用原应用。需要 distribution:UploadVersions 和目标应用授权,文件仍受可用空间与大小限制约束。

创建上传任务

为一次上传保存文件信息与幂等键,创建成功后立即保存 data.id,它就是后续查询和恢复使用的上传任务 ID。下面演示分片上传任务的创建,不包含后续文件传输。

Python SDK
def prepare_distribution_upload(client, app_id, file_name, size, upload_key):
    upload = client.create_multipart_upload(
        app_id, file_name, size, upload_key
    )["data"]
    return upload  # 先保存 upload["id"],再申请凭证并传输文件。

整包上传还需要文件 SHA-256 和原始 MD5 摘要的 Base64。每个字段的格式与大小限制见创建上传接口,不能用文件名或十六进制 MD5 文本代替摘要。

传输并确认分片

  1. 按服务端返回的分片大小切分原文件,为每片计算真实大小和 SHA-256。
  2. 申报分片后申请对应上传凭证,再按返回的方法、地址和请求头传输。
  3. 传输完成后确认该分片,检查 uploaded=true。
  4. 继续处理其余分片;存储服务 2xx 不能代替平台确认。

整包上传使用整包凭证发送整个原文件。存储地址只接收凭证指定的授权信息,不携带平台 AccessKey、Cookie 或平台 Authorization。

提交校验

整包传输完成或全部分片确认后,提交上传完成请求,再查询原任务。validating 表示平台仍在校验;succeeded 且返回版本 ID才可继续发布。

普通分发新版本保存后按平台规则成为发布版本,仍应读取版本列表检查 is_current。文件进度 100% 不代表已经校验或发布成功。

恢复或取消上传

使用原文件和原上传任务 ID 恢复。先查询分片列表,只补传未确认的片;凭证过期时重新申请同一上传任务或分片的凭证。

已开始校验或保存成功的上传任务不能取消。放弃仍在传输的上传时,可调用取消接口;清理结果与应用删除分别处理。更多错误见上传排错。