蒲公英文档中心

向安装包中添加设备 UDID

介绍如何为 Ad Hoc 分发的 iOS 应用添加设备 UDID,包括注册设备、生成描述文件、重新打包 IPA 的完整流程。

使用 Ad Hoc 方式分发 iOS 应用时,目标设备的 UDID 必须注册到应用的 mobileprovision 文件中,否则无法安装。本文说明如何将设备 UDID 添加到应用的 mobileprovision 文件。

前置要求

  • 一个苹果个人、公司或教育开发者账号(非企业账号)。关于账号类型的区别,请参见 iOS 应用签名证书的类型说明
  • 已获取待添加设备的 UDID。获取方式请参见 iOS 设备的 UDID
  • 一台安装有 Xcode 的 Mac 电脑。

如果您持有苹果企业开发者账号($299),可直接使用 In-House 方式打包,无需为每台设备添加 UDID。

添加 UDID 到开发者账号

  1. 登录 Apple Developer
  2. 进入 Certificates, Identifiers & Profiles → Devices
  3. 点击添加新设备,填写设备名称和 UDID。

创建 Provisioning Profile

  1. 进入 Certificates, Identifiers & Profiles → Profiles,点击创建,选择 Ad Hoc 类型。
  2. 选择对应的 App ID
  3. 选择对应的 Ad Hoc 证书。如果没有可用证书,请先 创建证书
  4. 勾选需要添加的设备。
  5. 填写 Provisioning Profile 名称,生成并下载配置文件。

重新打包 IPA

  1. 打开 Xcode,选择对应的项目。
  2. 选择 Any iOS Device (arm64) 作为运行目标。
  3. 点击 Product → Archive,等待打包完成。
  4. 点击 Distribute App
  5. 选择 Custom,点击下一步。
  6. 选择 Ad Hoc 类型,点击下一步。
  7. 选择 Manually manage signing 以手动指定证书和配置文件,点击下一步。
  8. 证书选择上一节使用的 Ad Hoc 证书,配置文件选择上一节下载的 Provisioning Profile。
  9. 生成 IPA 文件。
如果找不到已创建的证书,请关闭 Xcode 后重新打开项目。

上传安装包到蒲公英

上述方式生成的安装包上传到蒲公英后,已添加 UDID 的设备即可进行安装。这类应用会显示为 内测版,并展示该安装包 Provisioning Profile 中包含的 UDID 列表。

上传方式请参见 应用上传

创建 Ad Hoc 证书(可选)

如果尚未创建过 Ad Hoc 证书,可按以下步骤创建。

在 Mac 上生成 CSR 文件

  1. 打开 钥匙串访问
  2. 顶部菜单选择 证书助理 (Certificate Assistant) → 从证书颁发机构请求证书 (Request a Certificate From a Certificate Authority)
  3. 填写开发者账号邮箱和名称,选择 存储到磁盘
  4. 选择保存位置并完成。

上传 CSR 文件到 Apple Developer

  1. 登录 Apple Developer
  2. 进入 Certificates, Identifiers & Profiles → Certificates
  3. 点击 +,选择要创建的证书类型,进入下一步。
  4. 点击 Choose File,选择刚刚生成的 .certSigningRequest 文件。
  5. 点击 Continue,Apple 会生成 .cer 证书文件。
  6. 下载 .cer 文件,双击安装到钥匙串访问。

本页目录