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

创建与管理分发应用

本页内容

一个分发应用用于归集同一包名的版本、下载设置和用量。首次上传先创建应用,后续更新沿用原应用 ID。

选择创建或更新

平台上还没有这个应用时,先创建预留记录;上传更新版本时沿用原应用 ID。应用名称与备注可以单独修改,包名和平台要与安装包一致。

前提条件

准备自己的 API 凭据和真实文件信息。创建应用需要 distribution:CreateApps、distribution:UploadVersions 与对应功能许可,并且资源范围包含未来应用。

创建新应用

  1. 为本次创建保存幂等键,确定名称、包名与平台。
  2. 指定 module=distribution 创建应用。
  3. 保存返回的应用 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 确认结果。文件按平台保留规则处理;删除应用不会自动退款。