使用Xcode 14.2与macOS Monterey上传构建至AppStore时遇分发失败错误
解决Xcode 14.2上传App Store时的「Asset validation failed - Distribution failed with errors」错误
以下是针对Xcode 14.2 + macOS Monterey环境的具体解决步骤:
检查Info.plist核心字段
确认CFBundleShortVersionString(版本号)和CFBundleVersion(构建号)是纯数字加小数点的格式(比如2.1.3),不能包含字母、空格或特殊字符。同时核对CFBundleIdentifier和开发者后台的App ID完全一致,别出现拼写错误。验证资产文件合规性
- App图标:打开
Assets.xcassets的「App Icon」组,右键选择「Validate App Icons」,确保所有尺寸的图标都是PNG格式,没有透明层(通知图标除外),且命名符合规范。 - Launch Screen:检查Launch Screen的storyboard/xib文件,确认没有引用不存在的图片或资源,布局适配全设备尺寸,没有使用过时的约束。
- App图标:打开
清理缓存后重新构建
- 关闭Xcode,手动删除
~/Library/Developer/Xcode/DerivedData下对应项目的缓存文件夹 - 重新打开项目,按
Cmd+Shift+K清理构建缓存 - 选择「Generic iOS Device」或真机,按
Cmd+B重新构建项目
- 关闭Xcode,手动删除
确认证书与配置文件有效性
打开项目的「Signing & Capabilities」标签,确保选中的是App Store Distribution证书(不是开发证书),对应的配置文件是有效的App Store分发配置文件。也可以去Xcode偏好设置的「Accounts」里,选中你的Apple ID,点击「Manage Certificates」刷新证书,重新下载配置文件。先验证再上传
完成归档后,在Organizer里选中归档包,点击「Validate App」,跟着提示完成验证。这一步能提前揪出大部分资产验证问题,比直接上传更省时间。排查网络问题
确保网络稳定,没有被代理或防火墙拦截。可以试试切换手机热点,或者重启路由器后再尝试上传——Xcode 14.2上传时对网络稳定性要求不低,偶尔波动就会导致分发失败。

内容的提问来源于stack exchange,提问作者Kumar Lav
相关产品推荐
相关产品推荐

