macOS 10.15以下Swift标准库非必要嵌入问题的解决方案咨询

问题背景 #

macOS 10.15（Catalina）及以上系统自带Swift 5标准库，因此部署目标设为该版本后无需嵌入任何Swift库，包体积大幅缩小。但10.13-10.14系统没有预装Swift 5库，Xcode默认会嵌入全套Swift标准库，导致包体积膨胀。以下是仅嵌入必要库的可行方案：

方案1：手动筛选并嵌入必要依赖库 #

1. 编译项目后，右键应用包选择「显示包内容」，查看Contents/Frameworks下的Swift库文件。
2. 在终端执行otool -L 你的App路径/Contents/MacOS/你的App名称命令，查看二进制文件实际依赖的Swift库（输出里以@rpath/libswift开头的条目就是依赖）。
3. 打开Xcode的Build Phases -> Embed Frameworks，移除所有未出现在依赖列表里的Swift库。
4. 确保Build Settings中：
   • Always Embed Swift Standard Libraries设为No
   • Embedded Content Contains Swift Code设为Yes（必须开启，否则Xcode不会嵌入任何Swift库，导致低版本系统运行崩溃）
5. 在10.13-10.14系统上测试，确认应用能正常启动运行。

方案2：启用死代码剥离与链接优化 #

通过编译优化让Xcode自动剔除未使用的库和代码：

1. 在Build Settings中：
   • Linking -> Dead Code Stripping设为Yes
   • Swift Compiler - Code Generation -> Optimization Level设为Fast, Whole Module Optimization（Release模式默认开启，Debug模式也可尝试开启）
   • Linking -> Link-Time Optimization (LTO)设为Incremental或Full（Full优化力度更大，但编译时间更长）
2. 编译后检查Frameworks目录，Xcode会自动只嵌入实际被引用的Swift库，大幅减少冗余。

方案3：启用Library Evolution特性 #

Swift 5.1+支持的Library Evolution特性能优化库的分发和依赖处理：

1. 在Build Settings中，将Swift Compiler - Language -> Enable Library Evolution设为Yes
2. 配合方案2的优化设置，Xcode会更精准地识别所需的Swift库组件，避免嵌入全套库。

验证方法 #

每次调整设置后，用以下步骤确认优化效果：

1. 编译项目，查看应用包的Frameworks目录，只保留otool检测到的依赖库
2. 在目标系统（如10.13）上运行应用，确认无崩溃或启动失败问题
3. 对比优化前后的包体积，确保达到预期缩减效果

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