如何解决 Xcode 签名证书和 Provisioning Profile 过期问题

在 iOS 应用开发过程中，签名证书和 Provisioning Profile 是确保应用安全性和合法性的关键组件。然而，当这些证书或配置文件过期时，开发者可能会遇到编译或归档失败的问题。本文将详细介绍如何解决 Xcode 中"iOS Distribution"证书未找到和 Provisioning Profile 过期的问题。

问题描述

当你尝试在 Xcode 中构建或归档 iOS 应用时，可能会遇到以下错误信息：

Error (Xcode): No signing certificate "iOS Distribution" found: No "iOS Distribution" signing certificate matching team ID "xxxx" with a private key was found.
Error (Xcode): Provisioning profile "20230621Dev_adHoc" expired on Apr 29, 2025.

这些错误表明：

1. Xcode 无法找到与团队 ID 匹配的"iOS Distribution"签名证书。
2. 当前使用的 Provisioning Profile 已过期。

此外，Xcode 还会提示以下内容：

It appears that there was a problem signing your application prior to installation on the device.
Verify that the Bundle Identifier in your project is your signing id in Xcode.
Also try selecting 'Product > Build' to fix the problem.
Encountered error while archiving for device.

解决方案

1. 检查证书是否过期

首先，检查你的"iOS Distribution"证书是否过期。证书的有效期通常为一年，过期后需要重新生成。

• 检查证书有效期
  1. 打开 钥匙串访问（Keychain Access）。
  2. 在左侧栏中选择"登录"和"我的证书"。
  3. 查找"iOS Distribution"证书，双击证书查看其详细信息，确认证书是否已过期。

如果证书已过期，需要重新生成证书。

2. 重新生成证书

重新生成"iOS Distribution"证书的步骤如下：

1. 登录 Apple Developer 账户

   • 打开浏览器，访问 Apple Developer。
   • 使用你的 Apple ID 登录。

2. 进入证书管理页面

   • 在顶部菜单栏中选择"证书、ID 和配置文件"（Certificates, Identifiers & Profiles）。

3. 创建新的证书

   • 在左侧菜单中选择"证书"（Certificates）。
   • 点击"+"按钮，添加一个新的证书。
   • 选择"iOS Distribution"证书类型，然后点击"继续"（Continue）。

4. 生成证书请求

   • 按照提示在你的 Mac 上生成一个证书签名请求（CSR）文件。
   • 打开"钥匙串访问"，选择"证书助理 > 从证书颁发机构请求证书"。
   • 填写你的电子邮件地址和用户 ID，选择"存储在磁盘上"，然后点击"继续"。
   • 保存 CSR 文件到本地。

5. 上传 CSR 文件

   • 返回 Apple Developer 网站，上传刚才生成的 CSR 文件。
   • 点击"继续"并等待证书生成。

6. 下载并安装证书

   • 证书生成完成后，下载证书文件（.cer 格式）。
   • 双击下载的证书文件，将其安装到钥匙串中。

7. 验证证书

   • 再次打开"钥匙串访问"，确认新的"iOS Distribution"证书已安装，并且包含私钥。

3. 更新 Provisioning Profile

如果 Provisioning Profile 已过期，也需要更新。

1. 登录 Apple Developer 账户

   • 访问 Apple Developer，使用你的 Apple ID 登录。

2. 进入配置文件管理页面

   • 在顶部菜单栏中选择"证书、ID 和配置文件"（Certificates, Identifiers & Profiles）。
   • 在左侧菜单中选择"配置文件"（Provisioning Profiles）。

3. 编辑过期的配置文件

   • 找到过期的 Provisioning Profile（例如"20230621Dev_adHoc"）。
   • 点击"编辑"（Edit）按钮。

4. 重新生成配置文件

   • 点击"生成"（Generate）按钮，重新生成新的配置文件。
   • 下载新的配置文件到本地。

5. 安装新的配置文件

   • 双击下载的配置文件，Xcode 会自动将其添加到项目中。

6. 清理旧的配置文件

   • 打开终端，运行以下命令清理旧的配置文件：

     rm -rf ~/Library/MobileDevice/Provisioning\ Profiles/

   • 重新构建项目，Xcode 会自动下载新的配置文件。

4. 验证项目设置

在 Xcode 中，确保项目的签名设置正确：

1. 打开项目

   • 打开 Xcode，选择你的项目。
   • 点击项目的名称，进入"Targets > Signing & Capabilities"选项卡。

2. 手动管理签名

   • 取消自动管理签名（关闭"Automatically manage signing"）。
   • 手动选择新安装的"iOS Distribution"证书和新的 Provisioning Profile。

3. 清理并构建项目

   • 点击顶部菜单栏的"Product > Clean Build Folder"清理项目。
   • 然后选择"Product > Build"重新构建项目。

总结

通过以上步骤，你可以解决 Xcode 中"iOS Distribution"证书未找到和 Provisioning Profile 过期的问题。关键步骤包括：

1. 检查证书是否过期，并重新生成证书。
2. 更新过期的 Provisioning Profile。
3. 确保 Xcode 项目中的签名设置正确。

如果问题仍未解决，建议检查 Xcode 和 macOS 系统是否为最新版本，并尝试重启 Xcode 和电脑。希望这些方法能帮助你顺利解决签名问题，继续你的开发工作。