选择证书与设置签名参数
本页内容
在提交签名前,查看应用可用的证书,并按需要调整包名、Keychain 和插件处理方式。修改参数用于后续签名,已下载或已安装的旧包不会随配置自动改变。
前提条件
已开通签名服务,并准备应用 ID。查询证书、选择证书、读取参数和修改参数分别授权:enterprise:ReadCertificates、enterprise:SelectCertificates、enterprise:ReadSigningParameters、enterprise:UpdateSigningParameters。只需要默认设置时,可直接按签名指南提交任务。
选择可用证书
- 调用 列出可选签名证书,读取本应用当前套餐可选的证书。
- 根据证书备注、团队、到期信息和是否已选择等公开字段确定目标。
- 提交签名任务时,传入目标
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 时,重新读取差异并确认,不要直接用新修订号覆盖其他修改。
确认生效方式
保存成功只更新签名设置。需要让新设置进入安装包时,请提交一次新的签名任务,并下载该任务生成的签名版本。
设置不会改写已经下载或安装的旧包。选择证书也不能绕过套餐、有效期或签名准入检查。