iOS App 签名前,要核对哪些资料?
签名前最容易漏掉的是“哪一个 target、哪一个团队、发给哪一批设备”。只拿到应用名称和一份证书截图,往往答不出这三个问题。先把签名所需信息和业务功能列在同一份交接记录里,开发者才能判断应当调整项目设置、更新描述文件,还是回头确认交付方式。
第一栏写应用身份,给每个 target 单独留一行
记录项目中实际打包的 target、Bundle ID、版本号和构建号。比如开发用“便笺测试版”,交付用“便笺”,两个显示名称相近,却可能属于不同的应用记录。项目包含通知扩展、分享扩展等组件时,分别记下对应标识,不能只写主应用一行。报错如果点名某个扩展,先核对那一行;给主应用重新导出证书未必改变扩展的配置。
第二栏写签署团队和本次交付范围
列出由哪个开发团队签署、谁有权限管理标识和描述文件、谁执行归档。本机开发要知道运行设备和开发配置;Ad Hoc 交付要知道目标设备范围和分发配置;TestFlight 交付要确认有权限操作正确的 App Store Connect 应用记录,以及由谁负责测试组和构建。把这些责任写清楚即可,公开工单里无需放账号密码、证书密码或私钥。

第三栏把“需要的能力”和“实际获准的能力”对齐
以关联域名为例,应用希望从一个网页链接唤起指定页面。启用这项功能涉及项目 target 请求的 entitlement,以及对应 App ID 和签名配置允许的能力。Stack Overflow 上就有开发者在加入 Associated Domains 后遇到签名能力报错。交接时写出能力名称、报错原文、触发报错的 target、使用自动还是手动签名,比只写一句“证书有问题”更有助于缩小范围。
如果项目上周才新增能力,问清生成描述文件的时间。手动管理时,由有权限的成员核对标识上的服务,并按需更新、下载相应描述文件;自动签名时,检查 Xcode 选中的团队与目标,让项目负责人核对生成结果。应用已经签好并能安装、但网页链接仍没有唤起应用,则把问题转到关联域名配置及设备上的功能验证,别和导出失败混成一张工单。
交接实例:开发机能跑,导出时才失败
假设开发者在调试配置里使用测试版标识,并且已经启用了关联域名;归档使用发行配置,由另一名成员维护。两人同时说“我用的是同一个工程”并不矛盾。请归档负责人记录出错的配置、标识和团队,再与交接表逐项对照。若发现发行标识的能力尚未配置,安排相应管理员处理,并再次归档或导出验证。若标识和能力完全一致,再查实际选用的描述文件和签名证书。
交给测试者的精简版清单
- 安装哪一个应用、从哪个入口取得、预期显示什么版本和构建号。
- 用哪台设备、哪个系统版本,需要验证哪项与签名或权限相关的功能,例如点开约定的测试链接后能否进入正确页面。
- 安装失败时保留完整提示和发生阶段;安装成功但功能失败时,写出触发动作和实际结果。二者交给不同负责人处理。
验收可从一台约定设备开始。能安装和启动只覆盖签名链路的一部分,依赖权限的业务功能还要单独走一次。最后把交付文件、构建号和验收结果对应起来。若两份包都叫“最终版”,用版本号与构建号的记录方法补上可追溯的标识,再让下一位同事接手。