Xcode 7 中 CocoaPods 编译报错 dyld: Library not loaded: @rpath/Pods.framework/Pods

问题症状与解决

在 Xcode 7 beta 3 (7A152u) 中创建 Swift 项目，并使用 CocoaPods 做依赖管理，编译时会遇到如下的报错：

dyld: Library not loaded: @rpath/Pods.framework/Pods
  Referenced from: /private/var/mobile/Containers/Bundle/Application/26B91138-7483-40B0-9BE6-D27072472895/AppName.app/AppName
  Reason: image not found
(lldb) 

这个错误只在真机测试上遇到，模拟器没有问题。

解决方案是点击 target 的 Build Settings，切换到 All，搜索 bitcode，将其设置为 No，即可编译通过。

 

Bitcode 介绍

当项目进行编译时，Xcode 使用 clang 或者 swiftc 对项目进行编译，然后交给 LLVM 来创建二进制的包，以适配虚拟机（x86/64）和真机(arm6/arm7/arm7s/arm64)环境。这样得来的二进制包，被称为“胖二进制包”(Fat Binary)。

如果启用 Bitcode 的话，那么生成“胖二进制包”的过程会被去掉，LLVM 只会生成一个中间语言 bitcode 包。这么干是有不少好处的，但是就不能在所有环境运行了，所以后面一步打包工作总是需要有人来做的——App Store来干这个事儿。这样一来，包体积更小，运行也更快了，也是 iOS9 “瘦身功能”的一部分。未来，所有的 WatchOS 应用会强制 bitcode 提交，但 iOS 应用还没有这个要求。

 

参考

App Thinning (iOS, watchOS):
https://developer.apple.com/library/prerelease/watchos/documentation/IDEs/Conceptual/AppDistributionGuide/AppThinning/AppThinning.html

Fat Binary:
https://en.wikipedia.org/wiki/Fat_binary#Apple.27s_Universal_binary

LLVM:
https://zh.wikipedia.org/wiki/LLVM

Impact of Xcode build options “Enable bitcode” Yes/No:
http://stackoverflow.com/questions/31088618/impact-of-xcode-build-options-enable-bitcode-yes-no

Xcode 7 dyld:Library not loaded image not found:
https://github.com/CocoaPods/CocoaPods/issues/3661

dyld: Library not loaded: @rpath/Pods.framework/Pods
https://github.com/CocoaPods/CocoaPods/issues/3586