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

选择证书与设置签名参数

本页内容

在提交签名前,查看应用可用的证书,并按需要调整包名、Keychain 和插件处理方式。修改参数用于后续签名,已下载或已安装的旧包不会随配置自动改变。

前提条件

已开通签名服务,并准备应用 ID。查询证书、选择证书、读取参数和修改参数分别授权:enterprise:ReadCertificates、enterprise:SelectCertificates、enterprise:ReadSigningParameters、enterprise:UpdateSigningParameters。只需要默认设置时,可直接按签名指南提交任务。

选择可用证书

  1. 调用 列出可选签名证书,读取本应用当前套餐可选的证书。
  2. 根据证书备注、团队、到期信息和是否已选择等公开字段确定目标。
  3. 提交签名任务时,传入目标 certificate_id。列出证书不等于已经获得选择权限。

证书 ID 来自平台返回值,不是证书名称或 P12 文件。接口只返回可用证书的公开信息,不交付证书私钥或密码。

读取当前参数

调用 读取签名参数,保存当前设置与 revision。先向使用者展示当前状态,再决定是否修改。

设置用途常用取值
bundle_mode选择签名后使用的 Bundle ID 来源original 沿用原包;certificate 使用证书配置
keychain_mode选择 Keychain 访问组处理方式off 关闭同步;certificate 使用证书配置
remove_plugins选择插件处理方式none 保留;auto 自动处理

administrator、custom 和 selected 用于保留已有受限设置,不能借此创建任意固定包名、自定义 Keychain 或插件清单。允许值和保留条件以接口说明为准。

保存签名参数

带回刚读取的 revision 和本次修改的幂等键。下面的函数演示读取后保存;调用前先取得使用者对新设置的确认。

Python SDK
def save_signing_parameters(client, app_id, bundle_mode, keychain_mode,
                            remove_plugins, write_key):
    current = client.get_signing_parameters(app_id)["data"]
    return client.update_signing_parameters(app_id, {
        "revision": current["revision"],
        "bundle_mode": bundle_mode,
        "keychain_mode": keychain_mode,
        "remove_plugins": remove_plugins,
    }, write_key)["data"]

出现 RevisionConflict 时,重新读取差异并确认,不要直接用新修订号覆盖其他修改。

确认生效方式

保存成功只更新签名设置。需要让新设置进入安装包时,请提交一次新的签名任务,并下载该任务生成的签名版本。

设置不会改写已经下载或安装的旧包。选择证书也不能绕过套餐、有效期或签名准入检查。

相关接口