iOS 开发踩坑指南

原创已于 2026-01-19 15:30:48 修改 · 224 阅读

本内容遵循CC 4.0 BY-SA版权协议

于 2025-08-13 15:31:37 首次发布

Archive时Archives列表里面只有Other Items的问题

除了项目文件以外，把第三方库中Build Settings中Skip Install设置为Yes, Installation Directory设置位空，前提是先选择你要Archive的Target。
设置完成后，再重新Archive，就正常了！

提交时的 bitcode 问题

如果禁用Bitcode不起作用，你可以尝试手动从framework中剥离Bitcode。
打开终端。
运行命令：xcrun bitcode_strip -r <path_to_your_Framework> -o <output_path>，其中<path_to_your_Framework>是你的framework的实际路径。

pod 时出现 sandbox 错误

修改如下两个配置后重新编译尝试即可
首先，将 User Script Sandboxing 置为 NO
PROJECT => Build Settings => Build Options => User Script Sandboxing

其次，将 App Transport Security Settings 中 Allow Arbitrary Loads 置为 YES
TARGETS => info => Custom iOS Target Properties => App Transport Security Settings => Allow Arbitrary Loads
若初始配置中无此项，直接 add 添加即可

pod 权限问题

问题原因

Xcode User Script Sandboxing（用户脚本沙盒）
Xcode 14+ 默认启用了用户脚本沙盒（ENABLE_USER_SCRIPT_SANDBOXING = YES），这会阻止 CocoaPods 脚本执行，导致 "Operation not permitted" 错误。
解决办法：

将下述两个配置中将该设置改为 NO：
ENABLE_USER_SCRIPT_SANDBOXING = NO;

.debug.dylib 文件错误

问题原因
ENABLE_PREVIEWS = YES 会启用 SwiftUI 预览，Xcode 会尝试生成 .debug.dylib 用于预览。纯 Objective-C 项目，不需要该功能。
解决办法：
将 ENABLE_PREVIEWS 从 YES 改为 NO（Debug 和 Release 配置均已更新）：

ENABLE_PREVIEWS = NO;
ENABLE_PREVIEWS = NO;