朋友传回的Xcode项目在iPhone真机运行报错如何解决?
Xcode 真机运行签名报错解决方法
两个报错的根本原因是你朋友排查问题时,将他本地的开发团队、签名配置写入了项目文件,你的本地环境没有对应账号和匹配的描述文件,按如下步骤操作即可修复:
步骤1:替换项目开发团队配置
- 打开Xcode项目,点击左侧导航栏最顶部的项目根文件,进入项目设置页
- 选中「TARGETS」分类下你的应用主目标(名称含
finalProject的条目),切换到「Signing & Capabilities」标签 - 找到「Team」下拉框,删除朋友遗留的名为"X"的团队选项,选择你自己绑定了Apple ID的开发团队
- 若下拉列表无可用团队,点击「Add Account...」按提示登录你的Apple ID,普通个人Apple ID无需付费即可用于真机调试
步骤2:修正Bundle ID并开启自动签名
当前配置里的-.finalProject属于非法格式的Bundle ID,需要调整:
- 同「Signing & Capabilities」标签页下,找到「Bundle Identifier」输入框
- 将内容修改为符合规则的唯一标识,推荐格式为
com.自定义名称.finalProject,禁止以特殊符号开头、不能包含空格或非法字符 - 勾选「Automatically manage signing」选项,让Xcode自动生成适配你账号和设备的调试描述文件
步骤3:清理缓存重新构建
- 按下快捷键
Shift + Command + K,或点击顶部菜单栏「Product」→「Clean Build Folder」清理旧的构建缓存 - 重新插拔你的iPhone 11,首次运行需要在手机端信任开发者证书:打开手机「设置」→「通用」→「VPN与设备管理」,找到你的开发者账号条目点击信任即可
- 运行目标选择你的iPhone 11,重新点击运行按钮即可正常构建安装
异常排查
如果执行完上述步骤仍报错,可做如下操作:
- 打开Xcode顶部菜单栏「Xcode」→「Settings」→「Accounts」,选中你的Apple ID,点击右下角「Download Manual Profiles」手动拉取所有可用描述文件
- 检查你的iPhone 11系统版本,是否高于项目「General」标签页下「Minimum Deployments」设置的最低支持版本,若系统版本过低可升级手机系统,或调低项目的最低适配版本要求
内容的提问来源于stack exchange,提问作者Billy
相关产品推荐
相关产品推荐

