iOS 测试分发指南

获取 UDID 后,如何分发 Ad Hoc 测试包?

UDID 是用于登记测试设备的标识。拿到它之后,开发者还要在 Apple Developer 注册设备,让描述文件包含这台设备,并重新导出 IPA。DistKit 可以协助收集 UDID,但不会替你完成 Apple 侧注册或签名。

DistKit 产品指南 · 更新于

什么时候需要提供 UDID?

当团队通过 Development 或 Ad Hoc 方式直接分发 IPA 时,测试设备需要包含在对应描述文件中。如果测试邀请来自 TestFlight,请按 TestFlight 的流程加入,不要把两种分发方式混在一起。

已经登记过的设备也要核对是否进入了当前版本所用的描述文件。仅仅在开发者账户的设备列表中找到它,并不足以确认这份 IPA 可安装。

测试人员:提供设备标识,不提供账户密码

  1. 在 iPhone 的 Safari 中打开获取页面

    从团队给出的测试页面进入设备流程,或打开 DistKit 获取 UDID。先核对域名和发起团队;不要安装来源不明的配置描述文件。

  2. 阅读描述文件说明,再自行确认

    DistKit 使用 Profile Service 配置描述文件请求 UDID、硬件型号标识和 iOS 版本,不是 MDM 注册。只有你确认安装后才会回传设备信息;不需要把 Apple ID 密码交给测试团队。

  3. 将 UDID 发给负责签名的开发者

    设备流程的会话约 15 分钟过期,过期后从获取页面重新开始。通过团队认可的私密渠道提供标识,不要把结果页面或完整 UDID 公开发布。

完成收集只代表拿到了标识,不代表设备已登记或旧安装包已更新。手机上的具体提示会随系统版本变化,请以设备显示的说明为准。

开发者:登记设备,更新描述文件,再导出

  1. 在正确的开发者团队登记设备

    有权限的 Account Holder 或 Admin 在 Certificates, Identifiers & Profiles 的 Devices 中录入名称与 UDID,核对平台和标识后保存。参见 Apple:注册单台设备。

  2. 确保 Ad Hoc 描述文件包含该设备

    手动管理签名时,选择对应 App ID、分发证书和本次测试设备,生成并下载描述文件;使用自动签名时,由 Xcode 管理描述文件,但仍需核对导出结果。参见 Apple:创建 Ad Hoc 描述文件。

  3. 使用更新后的签名配置重新导出 IPA

    在 Xcode 或团队既有构建流程中导出新的测试包。不要把旧文件改个名字后再次上传:设备名单来自包内的 embedded.mobileprovision。

  4. 上传并核对版本,再通知测试人员

    在 DistKit 上传新版本,或按现有版本管理流程替换包。核对版本号、构建号、分发类型、描述文件有效期和设备数量,再检查分享链接实际指向的版本。安装是否完成仍由测试人员在设备上确认。

怎么确认这次更新真的生效?

Apple 侧
团队和设备登记正确,描述文件已经包含目标设备。
导出包
在本地解码这份 IPA 的描述文件,核对目标 UDID;不要只看后台列表或设备总数。
分享链接
打开的是新版本,链接未过期、未停用,密码和分发额度符合预期。

仍然失败时,按IPA 无法安装排查先定位失败阶段,再收集错误信息。重复收集同一台设备的 UDID,不会修复旧包中的描述文件。