Xcode7 新建的工程在真機上運行工程的時候,發現工程編譯不過。報錯信息如下:
‘/Users//Framework/SDKs/PolymerPay/Library/mobStat/libSDK.a(**ForSDK.o)’does not contain bitcode. You must rebuild it with bitcode enabled (Xcodesetting ENABLE_BITCODE), obtain an updated library from the vendor, or disablebitcode for this target. for architecture arm64
意思就是引用的一個三方庫不包含bitcode。關于bitcode網上相關資料已經比較多了,我自己再做個小的總結。
Bitcode 是什么?
官方文檔在App Distribution Guide – App Thinning (iOS, watchOS)一節中,找到了下面這樣一個定義:
Bitcode is an intermediate representation of a compiled program. Apps you upload to iTunes Connect that contain bitcode will be compiled and linked on the App Store. Including bitcode will allow Apple to re-optimize your app binary in the future without the need to submit a new version of your app to the store.
說的是bitcode是被編譯程序的一種中間形式的代碼。包含bitcode配置的程序將會在App store上被編譯和鏈接。bitcode允許蘋果在后期重新優化我們程序的二進制文件,而不需要我們重新提交一個新的版本到App store上。
繼續看,在What’s New in Xcode-New Features in Xcode 7中,還有一段如下的描述
Bitcode. When you archive for submission to the App Store, Xcode will compile your app into an intermediate representation. The App Store will then compile the bitcode down into the 64 or 32 bit executables as necessary.
當我們提交程序到App store上時,Xcode會將程序編譯為一個中間表現形式(bitcode)。然后App store會再將這個botcode編譯為可執行的64位或32位程序。
再看看這兩段描述都是放在App Thinning(App瘦身)一節中,可以看出其與包的優化有關了。喵大(@onevcat)在其博客開發者所需要知道的 iOS 9 SDK 新特性中也描述了iOS 9中蘋果在App瘦身中所做的一些改進,大家可以轉場到那去研讀一下。
Bitcode配置
在上面的錯誤提示中,提到了如何處理我們遇到的問題:
You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE), obtain an updated library from the vendor, or disable bitcode for this target. for architecture arm64
要么讓第三方庫支持,要么關閉target的bitcode選項。
實際上在Xcode 7中,我們新建一個iOS程序時,bitcode選項默認是設置為YES的。我們可以在”Build Settings”->”Enable Bitcode”選項中看到這個設置。
不過,我們現在需要考慮的是三個平臺:iOS,Mac OS,watchOS。
- 對應iOS,bitcode是可選的。
- 對于watchOS,bitcode是必須的。
- Mac OS不支持bitcode。
如果我們開啟了bitcode,在提交包時,下面這個界面也會有個bitcode選項:
如果依賴的第三方庫,而這個庫不支持bitcode,我們暫時只能設置ENABLE_BITCODE為NO,這樣就不影響編譯打包上線了。
所以,如果我們的工程需要支持bitcode,則必要要求所有的引入的第三方庫都支持bitcode。相信隨著時間推移,各大廠家的SDK都是支持bitcode的。
題外話
如上面所說,bitcode是一種中間代碼。LLVM官方文檔有介紹這種文件的格式,有興趣的可以移步LLVM Bitcode File Format。
參考
App Distribution Guide – App Thinning (iOS, watchOS)