Xcode 16上传App Store遇dSYM缺失警告，XCFramework体积优化咨询

是否必须包含dSYM？ #

是的，必须包含。Xcode 16的App Store上传流程对XCFramework的符号文件校验更为严格，缺少对应UUID的dSYM会直接触发「Upload Symbols Failed」警告。此外，dSYM是解析该框架引发的崩溃日志的核心文件，若你的App开启了Bitcode，Apple优化后的二进制文件也需要原始dSYM来关联符号，因此它是App Store分发的必要组成部分。

缩小dSYM体积的方法 #

1. 移除模拟器架构的dSYM #

模拟器版本的dSYM仅用于本地调试，上传App Store时完全不需要。你可以修改构建脚本，只保留真机架构的dSYM：

xcodebuild -create-xcframework \
-framework "../$IOS_ARCHIVE_PATH/Products/Library/Frameworks/$POD_NAME.framework" \
-debug-symbols "$PWD/../$IOS_ARCHIVE_PATH/dSYMs/$POD_NAME.framework.dSYM" \
-framework "../$IOS_SIM_ARCHIVE_PATH/Products/Library/Frameworks/$POD_NAME.framework" \
-output $OUTPUT_FRAMEWORK_PATH

此操作能直接砍掉模拟器dSYM带来的额外体积，同时满足App Store的符号校验要求。

2. 用dsymutil剥离冗余符号 #

针对真机dSYM，可使用dsymutil工具去除不必要的调试信息，进一步压缩体积：

# 剥离冗余符号并重命名
dsymutil -o stripped_$POD_NAME.framework.dSYM "$PWD/../$IOS_ARCHIVE_PATH/dSYMs/$POD_NAME.framework.dSYM"

注意：剥离后需用dwarfdump --uuid命令验证dSYM的UUID是否与框架二进制文件一致，确保符号能正常关联。

3. 优化框架的编译配置 #

在框架的Xcode项目中，针对Release配置做以下调整：

• 将DEBUG_INFORMATION_FORMAT设置为DWARF with dSYM File
• 关闭DEBUG相关编译宏（如DEBUG=1）
• 开启DEAD_CODE_STRIPPING（移除无用代码）
  这些配置能减少dSYM中生成的冗余符号数量，从源头控制体积。

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