求助：无法安装DeviceAgent，系统未找到有效iOSDeveloperIdentities

这个错误核心原因是代码签名身份配置异常，导致DeviceAgent无法被正确签名并安装到iOS设备上。结合你的环境（Xcode 9.2、iOS 11.2.6、run_loop 2.6.4），我整理了一步步的排查和解决方法：

1. 验证本地有效代码签名身份 #

首先确认你的系统里存在可用的iOS开发者证书：

• 打开Xcode，进入「偏好设置」→「Accounts」，选中你的Apple ID，查看「管理证书」里是否有有效的iOS Development证书。如果缺失，点击左下角「+」按钮重新生成，或者点击「Download Manual Profiles」同步最新配置。
• 用命令行快速验证：

  security find-identity -v -p codesigning
  

  输出结果里必须包含标注为iOS Developer的条目，如果没有，说明证书未正确安装或已过期，需要重新配置开发者账户的证书。

2. 确认设备已添加到开发者账户并授权 #

你的设备UDID是61b08575d55927c0dd0b9192e37a2c1f421cd000，请做以下检查：

• 登录Apple开发者后台，进入「Devices」列表，确认这个UDID已经被添加。如果未添加，手动添加后重新生成对应的开发描述文件。
• 用USB连接设备到电脑，打开Xcode的「Window」→「Devices and Simulators」，确保设备状态显示为「Ready」。如果提示「未授权」，需要在设备的「设置」→「通用」→「设备管理」里信任当前电脑的开发者证书。

3. 手动重签名DeviceAgent-Runner.app（自动签名失败时） #

如果自动签名流程卡壳，可以尝试手动重签名后再安装：

1. 先从原App中提取权限配置文件：

   codesign -d --entitlements - /Users/testmaskin/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/gems/run_loop-2.6.4/lib/run_loop/device_agent/ipa/DeviceAgent-Runner.app > /tmp/entitlements.plist
   

2. 用你的iOS开发者证书重签名App（替换"你的iOS Developer证书名称"为实际证书名，比如"iPhone Developer: Your Name (XXXXXXX)"）：

   codesign -f -s "你的iOS Developer证书名称" --entitlements /tmp/entitlements.plist /Users/testmaskin/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/gems/run_loop-2.6.4/lib/run_loop/device_agent/ipa/DeviceAgent-Runner.app
   

3. 重签名完成后，再执行原来的iOSDeviceManager安装命令，或者直接用Xcode将这个App安装到设备上测试是否能正常启动。

4. 排查更详细的错误日志 #

安装时的CBXException可以通过开启调试日志定位具体问题：

/Users/testmaskin/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/gems/run_loop-2.6.4/lib/run_loop/device_agent/bin/iOSDeviceManager install /Users/testmaskin/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/gems/run_loop-2.6.4/lib/run_loop/device_agent/ipa/DeviceAgent-Runner.app --device-id 61b08575d55927c0dd0b9192e37a2c1f421cd000 --log-level debug

调试日志会输出更具体的签名失败原因，比如描述文件不匹配、证书过期等。

5. 检查钥匙串权限 #

有时候钥匙串的证书权限会导致签名失败：

• 打开「钥匙串访问」，找到你的iOS Developer证书，右键选择「显示简介」。
• 在「信任」标签下，将「使用此证书时」设置为「始终信任」，然后关闭窗口并输入密码保存设置。

先从证书和设备授权这两个最常见的点入手排查，大部分情况下都能解决这个问题。

内容的提问来源于stack exchange，提问作者Sankalp