创建与管理分发应用
本页内容
一个分发应用用于归集同一包名的版本、下载设置和用量。首次上传先创建应用,后续更新沿用原应用 ID。
选择创建或更新
平台上还没有这个应用时,先创建预留记录;上传更新版本时沿用原应用 ID。应用名称与备注可以单独修改,包名和平台要与安装包一致。
前提条件
准备自己的 API 凭据和真实文件信息。创建应用需要 distribution:CreateApps、distribution:UploadVersions 与对应功能许可,并且资源范围包含未来应用。
创建新应用
- 为本次创建保存幂等键,确定名称、包名与平台。
- 指定
module=distribution创建应用。 - 保存返回的应用 ID,在
expires_at前完成首次上传。
Python SDK
def create_distribution_app(client, name, bundle_id, platform, create_key):
return client.create_app(
"distribution", platform, name, bundle_id, create_key
)["data"]预留记录没有可用安装包。创建响应丢失时以原请求和原幂等键恢复;已保存应用 ID 时可查询创建状态。过期后先核对应用列表,不直接重复创建。
查询应用
按名称、备注或包名关键词查询。首次省略游标,后续保持相同筛选条件。
Python SDK
def list_distribution_apps(client, keyword, cursor=None):
return client.list_apps(
module="distribution", search=keyword, limit=50, cursor=cursor
)["data"]取得完整应用 ID 后查询详情,核对当前账号、平台和包名。读取企业签名模块得到的 ID不能直接当作普通分发应用使用。
修改名称和备注
先读取应用资料与 revision,向使用者确认修改,再带回原修订号保存。备注清空时传空字符串。遇到 RevisionConflict,重新读取差异;不能把它当作网络错误直接覆盖。
删除应用
向使用者展示将删除的名称、包名与完整应用 ID,取得确认后再提交删除,并保存回执。confirm_app_id 必须与目标一致,SDK 会填写此字段。
查看 state 与 files_retained 确认结果。文件按平台保留规则处理;删除应用不会自动退款。