上传与更新 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.jsonpython 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方式二:自行调用上传接口
- 为一次上传保存文件信息和幂等键,调用 创建上传任务。立即保存返回的上传任务 ID。
- 整包上传调用 获取整包上传凭证,按返回值传输整个文件。分片上传先 申报分片摘要,再 获取分片上传凭证,传输后 确认分片已上传。
- 整包传输成功或全部分片确认后,调用 提交安装包校验提交校验。
- 使用原任务 ID 调用 查询上传任务,等待保存完成。
上传任务 ID 用来管理这一份上传;上传凭证是有时限的存储访问授权。凭证过期时为原任务重新申请,无需创建另一个应用或上传任务。
整包上传需要实际大小、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 接管恢复。
自行恢复分片上传时,先 查询已申报的分片,核对大小、序号和摘要,只补传未确认的分片。放弃传输时可对仍在上传的任务调用 取消未完成上传;已经开始校验或已成功保存的任务不能取消。
相关接口
- 创建上传任务POST
/api/v1/apps/{app_id}/uploads - 列出应用上传任务GET
/api/v1/apps/{app_id}/uploads - 查询上传任务GET
/api/v1/apps/{app_id}/uploads/{upload_id} - 获取整包上传凭证GET
/api/v1/apps/{app_id}/uploads/{upload_id}/ticket - 申报分片摘要POST
/api/v1/apps/{app_id}/uploads/{upload_id}/parts - 获取分片上传凭证GET
/api/v1/apps/{app_id}/uploads/{upload_id}/parts/{part_number}/ticket - 确认分片已上传POST
/api/v1/apps/{app_id}/uploads/{upload_id}/parts/{part_number}/complete - 查询已申报的分片GET
/api/v1/apps/{app_id}/uploads/{upload_id}/parts - 提交安装包校验POST
/api/v1/apps/{app_id}/uploads/{upload_id}/complete - 取消未完成上传POST
/api/v1/apps/{app_id}/uploads/{upload_id}/abort