App签名坊 24小时在线客服
全部签名指南

App签名坊 · 开发者指南

iOS App 签名前,要核对哪些资料?

签名前最容易漏掉的是“哪一个 target、哪一个团队、发给哪一批设备”。只拿到应用名称和一份证书截图,往往答不出这三个问题。先把签名所需信息和业务功能列在同一份交接记录里,开发者才能判断应当调整项目设置、更新描述文件,还是回头确认交付方式。

第一栏写应用身份,给每个 target 单独留一行

记录项目中实际打包的 target、Bundle ID、版本号和构建号。比如开发用“便笺测试版”,交付用“便笺”,两个显示名称相近,却可能属于不同的应用记录。项目包含通知扩展、分享扩展等组件时,分别记下对应标识,不能只写主应用一行。报错如果点名某个扩展,先核对那一行;给主应用重新导出证书未必改变扩展的配置。

第二栏写签署团队和本次交付范围

列出由哪个开发团队签署、谁有权限管理标识和描述文件、谁执行归档。本机开发要知道运行设备和开发配置;Ad Hoc 交付要知道目标设备范围和分发配置;TestFlight 交付要确认有权限操作正确的 App Store Connect 应用记录,以及由谁负责测试组和构建。把这些责任写清楚即可,公开工单里无需放账号密码、证书密码或私钥。

依次核对 Xcode target 请求的能力、开发团队与 App ID 允许的能力、本次归档导出的配置。
当报错提到某项能力时,从出错的 target 顺着三层记录向下核对。(App签名坊制图)

第三栏把“需要的能力”和“实际获准的能力”对齐

以关联域名为例,应用希望从一个网页链接唤起指定页面。启用这项功能涉及项目 target 请求的 entitlement,以及对应 App ID 和签名配置允许的能力。Stack Overflow 上就有开发者在加入 Associated Domains 后遇到签名能力报错。交接时写出能力名称、报错原文、触发报错的 target、使用自动还是手动签名,比只写一句“证书有问题”更有助于缩小范围。

社区原帖 · 加入关联域名后遇到签名能力问题

如果项目上周才新增能力,问清生成描述文件的时间。手动管理时,由有权限的成员核对标识上的服务,并按需更新、下载相应描述文件;自动签名时,检查 Xcode 选中的团队与目标,让项目负责人核对生成结果。应用已经签好并能安装、但网页链接仍没有唤起应用,则把问题转到关联域名配置及设备上的功能验证,别和导出失败混成一张工单。

Apple · 更新描述文件

交接实例:开发机能跑,导出时才失败

假设开发者在调试配置里使用测试版标识,并且已经启用了关联域名;归档使用发行配置,由另一名成员维护。两人同时说“我用的是同一个工程”并不矛盾。请归档负责人记录出错的配置、标识和团队,再与交接表逐项对照。若发现发行标识的能力尚未配置,安排相应管理员处理,并再次归档或导出验证。若标识和能力完全一致,再查实际选用的描述文件和签名证书。

Apple · 排查 entitlement 问题

交给测试者的精简版清单

  • 安装哪一个应用、从哪个入口取得、预期显示什么版本和构建号。
  • 用哪台设备、哪个系统版本,需要验证哪项与签名或权限相关的功能,例如点开约定的测试链接后能否进入正确页面。
  • 安装失败时保留完整提示和发生阶段;安装成功但功能失败时,写出触发动作和实际结果。二者交给不同负责人处理。

验收可从一台约定设备开始。能安装和启动只覆盖签名链路的一部分,依赖权限的业务功能还要单独走一次。最后把交付文件、构建号和验收结果对应起来。若两份包都叫“最终版”,用版本号与构建号的记录方法补上可追溯的标识,再让下一位同事接手。