Swift 專案在整合阿里雲與百度地圖 SDK 之後,執行 Archive 打包時中途中止,訊息如下:
ld: bitcode bundle could not be generated because
'/Users/zhangxitao/work/shine-ios/Carthage/Build/iOS/AliyunOSSiOS.framework/AliyunOSSiOS(OSSHTTPDNSMini.o)'
was built without full bitcode.
All object files and libraries for bitcode must be generated from Xcode Archive
or Install build for architecture armv7
Bitcode 是 Apple 提出的一種中間表示形式,App 上傳 App Store 後,Apple 會在伺服器端重新編譯與最佳化,以便日後針對不同 CPU 架構拆分出最精簡的執行檔。
問題在於:Bitcode 要求整條鏈路上的每一個目的檔與靜態庫都必須帶有完整的 bitcode 資訊。一旦其中任何一個依賴是在沒有開啟 Bitcode 的情況下編出來的,linker 就無法生成完整的 bundle,於是報出上面這個錯誤。
這個專案的 AliyunOSSiOS.framework 是透過 Carthage 取得的,而當時的編譯設定並沒有把 bitcode 嵌進去,所以缺了這一塊。
在 build 流程的腳本中,於 xcodebuild 指令加上 OTHER_CFLAGS:
xcodebuild OTHER_CFLAGS="-fembed-bitcode" -target XXXX build
-fembed-bitcode 的作用是強制在編譯產物中嵌入 bitcode,如此 linker 便能取得完整的 bundle。
如果是自己編譯的 framework,可以在該 target 的 Build Settings 中找到 Enable Bitcode,設為 YES;同時確認 Build Options 中的 Other C Flags / Other Swift Flags 沒有把相關參數排除掉。
把 target 的 Enable Bitcode 設為 NO 也能讓編譯通過,但這只是繞過問題:日後若要提交帶 Bitcode 的版本仍會卡住。因此這個做法只適合暫時不需上架的企業內部包或測試包。
用 Carthage 建置 framework 時,預設不會帶 Bitcode。官方建議的做法是在建置時加上 --no-use-binaries 讓它從原始碼重新編譯,或明確指定 BUILD_LIBRARY_FOR_DISTRIBUTION(Xcode 11 之後的XCFramework 流程),確保產物含有 Bitcode 資訊。若第三方只提供預編譯的 binary,則需要請對方重新出一份開啟 Bitcode 的版本。