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

上传与更新 IPA

本页内容

将本地 IPA 保存为企业签名应用的原包版本。上传包括创建任务、传输文件、提交校验和取得版本 ID;取得原包版本后,才能提交签名任务。

选择接入方式

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

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

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

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

可直接使用本页的 Python 上传工具,其他语言使用对应 SDK 的上传助手。自行实现 HTTP 时,再按下方步骤调用。

前提条件

  • 已取得目标企业签名应用 ID;新应用先按创建应用指南完成预留。
  • 准备真实 IPA,Bundle ID 和应用一致,并确认账号空间与上传大小限制。
  • API 应用有 enterprise:UploadVersions 权限及对应应用范围。新建还需 enterprise:CreateApps,工具查询应用时还需 enterprise:ReadApps。

方式一:使用上传工具

下载Python SDK 与企业签名示例,按快速入门配置环境。在源码包解压目录执行相应命令。每次独立上传使用新的状态文件。

新应用首次上传
python enterprise_upload.py new app.ipa --state new-upload.json
已有应用更新
python enterprise_upload.py update app-v2.ipa --app "<原应用ID>" --state version-2-upload.json

工具默认使用分片上传,并在传输前保存任务 ID 和幂等键。上传新版本会保留同一个应用 ID,并生成新的原包版本 ID;不会自动开通服务或提交签名。

手动填写名称和 Bundle ID

工具可读取普通 IPA 内 XML 或二进制格式的 Info.plist。需要手动指定名称,或处理 ZIP64 元数据时,同时填写与实际 IPA 一致的名称和包名。平台仍会检查文件真实内容。

指定应用信息
python enterprise_upload.py new app.ipa --name "星河阅读" --bundle-id com.example.reader --state reader-upload.json

方式二:自行调用上传接口

  1. 为一次上传保存文件信息和幂等键,调用 创建上传任务。立即保存返回的上传任务 ID。
  2. 整包上传调用 获取整包上传凭证,按返回值传输整个文件。分片上传先 申报分片摘要,再 获取分片上传凭证,传输后 确认分片已上传。
  3. 整包传输成功或全部分片确认后,调用 提交安装包校验提交校验。
  4. 使用原任务 ID 调用 查询上传任务,等待保存完成。

上传任务 ID 用来管理这一份上传;上传凭证是有时限的存储访问授权。凭证过期时为原任务重新申请,无需创建另一个应用或上传任务。

存储请求只携带上传凭证指定的授权信息。平台 AccessKey、Cookie 和平台 Authorization 请求头不要发送到存储地址。

整包上传需要实际大小、SHA-256,以及原始 MD5 摘要的 Base64;分片上传按接口返回的分片规则计算每片摘要。字段约束和完整请求见相关接口;完整传输说明见上传安装包。

确认校验结果

状态含义与下一步
uploading继续传输原文件并确认分片。
validating文件已提交校验,按有限间隔继续查询原任务。
succeeded校验并保存成功;取得 version_id 后,可将该原包版本用于签名。
failed / cancelled上传已经结束,查看 error_code。不能作为可签名版本使用。

文件传输进度达到 100% 不等于版本保存成功。请以平台任务状态和 version_id 为准。

恢复或取消上传

工具中断后,保留原 IPA 和状态文件,执行:

恢复原上传
python enterprise_upload.py resume app.ipa --state new-upload.json

文件、网站、账号和 AccessKey ID 必须与原操作一致。状态文件不含 Secret 或存储地址,但包含本地恢复信息,应私有保存。轮换 AccessKey 后,可在同一 API 应用下查询 列出应用上传任务,核对原文件后使用 SDK 接管恢复。

自行恢复分片上传时,先 查询已申报的分片,核对大小、序号和摘要,只补传未确认的分片。放弃传输时可对仍在上传的任务调用 取消未完成上传;已经开始校验或已成功保存的任务不能取消。

相关接口