XCode 13.2.1无法在iPhone物理设备安装应用的问题求助

环境信息 #

• XCode版本：13.2.1
• iPhone设备：iPhone14,3，系统版本15.1.1
• 已执行操作：原配置证书过期，已创建并下载最新证书至XCode项目，尝试过自动签名、手动签名两种方式

错误详情 #

无法安装"ZigBank"
Domain: com.apple.dt.MobileDeviceErrorDomain
Code: -402620395
User Info: {
DVTErrorCreationDateKey = "2022-08-11 07:55:57 +0000";
IDERunOperationFailingWorker = IDEInstalliPhoneLauncher;
}

未找到此可执行文件的有效配置描述文件。
Domain: com.apple.dt.MobileDeviceErrorDomain
Code: -402620395
User Info: {
DVTRadarComponentKey = 487925;
MobileDeviceErrorCode = "(0xE8008015)";
"com.apple.dtdevicekit.stacktrace" = (
0 DTDeviceKitBase 0x0000000118f0abec DTDKCreateNSErrorFromAMDErrorCode + 272
1 DTDeviceKitBase 0x0000000118f463f4 __90-[DTDKMobileDeviceToken installApplicationBundleAtPath:withOptions:andError:withCallback:]_block_invoke + 160
2 DVTFoundation 0x000000010272b964 DVTInvokeWithStrongOwnership + 76
3 DTDeviceKitBase 0x0000000118f46144 -[DTDKMobileDeviceToken installApplicationBundleAtPath:withOptions:andError:withCallback:] + 1312
4 IDEiOSSupportCore 0x000000011e4dfa60 __118-[DVTiOSDevice(DVTiPhoneApplicationInstallation) processAppInstallSet:appUninstallSet:installOptions:completionBlock:]_block_invoke.292 + 2908
5 DVTFoundation 0x0000000102856684 DVT_CALLING_CLIENT_BLOCK + 16
6 DVTFoundation 0x0000000102857c70 __DVTDispatchAsync_block_invoke + 564
7 libdispatch.dylib 0x00000001c18925f0 _dispatch_call_block_and_release + 32
8 libdispatch.dylib 0x00000001c18941b4 _dispatch_client_callout + 20
9 libdispatch.dylib 0x00000001c189b8a8 _dispatch_lane_serial_drain + 668
10 libdispatch.dylib 0x00000001c189c404 _dispatch_lane_invoke + 392
11 libdispatch.dylib 0x00000001c18a6c98 _dispatch_workloop_worker_thread + 648
12 libsystem_pthread.dylib 0x00000001c1a54360 _pthread_wqthread + 288
13 libsystem_pthread.dylib 0x00000001c1a53080 start_wqthread + 8
);
}

分析事件详情 #

{
    "device_model": "iPhone14,3",
    "device_osBuild": "15.1.1 (19B81)",
    "device_platform": "com.apple.platform.iphoneos",
    "launchSession_schemeCommand": "Run",
    "launchSession_state": 1,
    "launchSession_targetArch": "arm64",
    "operation_duration_ms": 29447,
    "operation_errorCode": "-402620395",
    "operation_errorDomain": "com.apple.dt.MobileDeviceErrorDomain",
    "operation_errorWorker": "IDEInstalliPhoneLauncher",
    "operation_name": "IDEiPhoneRunOperationWorkerGroup",
    "param_consoleMode": 0,
    "param_debugger_attachToExtensions": 0,
    "param_debugger_attachToXPC": 1,
    "param_debugger_type": 5,
    "param_destination_isProxy": 0,
    "param_destination_platform": "com.apple.platform.iphoneos",
    "param_diag_MainThreadChecker_stopOnIssue": 0,
    "param_diag_MallocStackLogging_enableDuringAttach": 0,
    "param_diag_MallocStackLogging_enableForXPC": 1,
    "param_diag_allowLocationSimulation": 1,
    "param_diag_gpu_frameCapture_enable": 0,
    "param_diag_gpu_shaderValidation_enable": 0,
    "param_diag_gpu_validation_enable": 0,
    "param_diag_memoryGraphOnResourceException": 0,
    "param_diag_queueDebugging_enable": 1,
    "param_diag_runtimeProfile_generate": 0,
    "param_diag_sanitizer_asan_enable": 0,
    "param_diag_sanitizer_tsan_enable": 0,
    "param_diag_sanitizer_tsan_stopOnIssue": 0,
    "param_diag_sanitizer_ubsan_stopOnIssue": 0,
    "param_diag_showNonLocalizedStrings": 0,
    "param_diag_viewDebugging_enabled": 1,
    "param_diag_viewDebugging_insertDylibOnLaunch": 1,
    "param_install_style": 0,
    "param_launcher_UID": 2,
    "param_launcher_allowDeviceSensorReplayData": 0,
    "param_launcher_kind": 0,
    "param_launcher_style": 0,
    "param_launcher_substyle": 0,
    "param_runnable_appExtensionHostRunMode": 0,
    "param_runnable_productType": "com.apple.product-type.application",
    "param_runnable_swiftVersion": "5.5.2",
    "param_runnable_type": 2,
    "param_testing_launchedForTesting": 0,
    "param_testing_suppressSimulatorApp": 0,
    "param_testing_usingCLI": 0,
    "sdk_canonicalName": "iphoneos15.2",
    "sdk_osVersion": "15.2",
    "sdk_variant": "iphoneos"
}

解决方案 #

该错误核心是配置描述文件与证书、设备不匹配或未正确关联，可按以下步骤排查修复：

1. 清理本地证书与描述文件缓存 #

• 打开XCode，进入XCode > 设置 > 账户，选中你的开发者账号，点击管理证书，删除过期证书，确认新证书已存在
• 前往~/Library/MobileDevice/Provisioning Profiles文件夹，删除所有旧配置描述文件
• 重启XCode

2. 验证开发者后台的配置描述文件 #

• 登录Apple开发者后台，检查新创建的配置描述文件：
  • 确认已绑定当前使用的新签名证书
  • 确认已添加目标iPhone的UDID
  • 确认描述文件的Bundle ID与项目中的Bundle ID完全一致（区分大小写）
• 重新下载配置描述文件，双击导入XCode

3. 检查项目签名配置 #

• 打开项目Build Settings，搜索Code Signing：
  • 自动签名：勾选自动管理签名，选择正确的开发者团队，让XCode自动匹配描述文件
  • 手动签名：在Provisioning Profile选项中，手动选择刚下载的、匹配Bundle ID和设备的描述文件
• 确认Target和Project层级的签名设置一致，避免配置冲突

4. 设备端信任开发者证书 #

• 在iPhone上打开设置 > 通用 > VPN与设备管理，找到你的开发者账号证书，点击信任
• 若未找到该选项，重新连接设备并尝试安装应用，触发信任提示

5. 清理项目并重新构建 #

• 执行产品 > 清理构建文件夹（快捷键Cmd+Shift+K）
• 断开并重新连接iPhone，再次执行产品 > 运行

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