iOS開發(fā) XCFramework

我們先看一個(gè) Xcode 12 編譯時(shí)的常見錯(cuò)誤怕享，GMObjC.framework 同時(shí)包含 x86_64 arm64 架構(gòu)，在 Xcode 12 之前的版本嫩絮，編譯時(shí)并不會(huì)報(bào)錯(cuò)藻治，但現(xiàn)在卻報(bào)錯(cuò)如下：

# 當(dāng)在真機(jī)運(yùn)行時(shí)限书，編譯報(bào)錯(cuò)
xx.xcodeproj Building for iOS, but the linked and embedded framework 'GMObjC.framework' was built for iOS + iOS Simulator.
# 當(dāng)在模擬器運(yùn)行時(shí)，編譯報(bào)錯(cuò)
xx.xcodeproj Building for iOS Simulator, but the linked and embedded framework 'GMObjC.framework' was built for iOS + iOS Simulator.

很明顯烹卒，新版本 Xcode 在使用包含多架構(gòu)的庫時(shí)會(huì)報(bào)錯(cuò)闷盔。從 stackoverflow 很容易找到解決方案，在工程的 Build Settings -> Excluded Architectures 依次添加編譯對應(yīng)架構(gòu)時(shí)旅急，需要排除的架構(gòu)逢勾。

以包含 x86_64 arm64 架構(gòu)的 GMObjC.framework 為例，在編譯模擬器時(shí)藐吮，需要移除 arm64 架構(gòu)溺拱；同理編譯真機(jī)時(shí)，需要移除 x86_64 架構(gòu)谣辞。選擇 Excluded Architectures盟迟，點(diǎn)擊加號”?“，依次添加Any iOS Simulator 值為 arm64潦闲，Any iOS 值為 x86_64攒菠，再次編譯即可通過。

image.png

XCFramework 是什么

首先回顧一下 iOS 開發(fā)中的靜態(tài)庫和動(dòng)態(tài)庫歉闰。

靜態(tài)庫(.a/.framework)：鏈接時(shí)完整地拷貝至可執(zhí)行文件中辖众，被多次使用就有多份冗余拷貝卓起；
動(dòng)態(tài)庫(.dylib/.tbd/.framework)：程序運(yùn)行時(shí)由系統(tǒng)動(dòng)態(tài)加載到內(nèi)存，系統(tǒng)動(dòng)態(tài)庫可被多個(gè)程序共享凹炸。

XCFramework 是蘋果新出的庫類型戏阅，在 Xcode 11 及 cocoapods 1.9 以上版本被支持，與普通動(dòng)態(tài)庫/靜態(tài)庫最大的區(qū)別是將多個(gè)平臺的二進(jìn)制庫啤它，捆綁到一個(gè)可分發(fā)的.xcframework捆綁包中奕筐，支持所有的蘋果平臺和架構(gòu)。

這里的關(guān)鍵詞是多個(gè)平臺（iOS, macOS, tvOS, watchOS, iPadOS, carPlayOS）变骡，我們使用的普通動(dòng)態(tài)庫/靜態(tài)庫屬于fat file离赫，僅僅是包含多個(gè)架構(gòu)，如armv7 armv7s arm64 arm64e x86_64等塌碌，而 XCFramework 可以包含 iOS 設(shè)備渊胸，iOS 模擬器和 Mac Catalyst 等多個(gè)平臺的二進(jìn)制庫。

蘋果引入 XCFramework 支持所有蘋果平臺台妆，以支持蘋果想實(shí)現(xiàn)大一統(tǒng)的規(guī)劃翎猛，而且 XCFramework 編譯的 Swift 庫，使用者不再需要使用相同 Xcode 版本編譯器（使用 Swift 庫實(shí)現(xiàn)組件化的開發(fā)者應(yīng)該深有感觸）接剩，對比使用 .framework 格式切厘，使用 .xcframework 格式 APP 包大小和啟動(dòng)速度都有提升。

制作 XCFramework

制作 XCFramework 很簡單懊缺，通過xcodebuild -create-xcframework命令即可完成迂卢，我通過合并 GMObjC 庫的模擬器和真機(jī)版本來演示。

當(dāng)前文件夾下有編譯好的 GMObjC.framework 分別是真機(jī)版本和模擬器版本桐汤。

.
├── Release-iphoneos
│   ├── 0CD1FB8D-9D63-3092-B68B-2E579A306D3F.bcsymbolmap
│   ├── GMObjC.framework
│   └── GMObjC.framework.dSYM
└── Release-iphonesimulator
    ├── GMObjC.framework
    └── GMObjC.framework.dSYM

通過xcodebuild -create-xcframework命令來合并為 XCFramework而克。

# 創(chuàng)建合并包 GMObjC.xcframework
xcodebuild -create-xcframework -framework Release-iphoneos/GMObjC.framework -framework Release-iphonesimulator/GMObjC.framework -output GMObjC.xcframework
# 或者換行展示更清晰
xcodebuild -create-xcframework \
           -framework Release-iphoneos/GMObjC.framework \
           -framework Release-iphonesimulator/GMObjC.framework \
           -output GMObjC.xcframework

合并后的 GMObjC.xcframework 目錄結(jié)構(gòu)如下，包含 arm64 和 x86_64 版本怔毛，這和 lipo 操作類似员萍，合并其他平臺時(shí)操作類似。

GMObjC.xcframework
├── Info.plist
├── ios-arm64
│   └── GMObjC.framework
└── ios-x86_64-simulator
    └── GMObjC.framework

如果是靜態(tài)庫 .a 文件拣度，則需要用-library和-headers來指定靜態(tài)庫和頭文件碎绎。

xcodebuild -create-xcframework \
           -library Release-iphoneos/GMObjC.a \
           -headers Release-iphoneos/include/GMObjC \
           -library Release-iphonesimulator/GMObjC.a \
           -headers Release-iphonesimulator/include/GMObjC \
           -output GMObjC.xcframework

使用 XCFramework

如何使用 .xcframework 文件，選擇當(dāng)前工程 Target抗果，選擇 General 目錄下的 Frameworks,Libraries,and Embedded Content拖入 .xcframework 文件即可筋帖，和使用 .framework 文件幾乎一樣。

image.png

一鍵編譯 XCFramework

編譯 XCFramework 需要使用命令xcodebuild -create-xcframework冤馏，寫成 shell 文件更方便日麸，放在 .xcodeproj 文件同級目錄下，填入 scheme 名稱，拖入終端回車即可生成代箭。

腳本只寫了 iPhone 真機(jī)和模擬器的合并墩划，其他平臺類似，自行添加修改即可嗡综，查看示例在 GMObjCFramework 文件夾中乙帮，下載后腳本拖入終端運(yùn)行，可看到生成的 GMObjC.xcframework 在 build 目錄下极景。

#!/bin/sh
# 放在與 .xcodeproj 文件同級目錄下察净，生成結(jié)果在 build 目錄下

# 需要編譯的 scheme
scheme="GMObjCFramework"

if [ -z "$scheme" ] || [ "$scheme" = "" ]; then
     echo "請?zhí)钊?scheme 名稱"
fi

echo "scheme: $scheme"
cd "$(dirname "$0")" || exit 0

xcodebuild archive \
    -scheme "$scheme" \
    -sdk iphoneos \
    -archivePath "archives/ios_devices.xcarchive" \
    BUILD_LIBRARY_FOR_DISTRIBUTION=YES \
    SKIP_INSTALL=NO

xcodebuild archive \
    -scheme "$scheme" \
    -sdk iphonesimulator \
    -archivePath "archives/ios_simulators.xcarchive" \
    BUILD_LIBRARY_FOR_DISTRIBUTION=YES \
    SKIP_INSTALL=NO

# 優(yōu)先從 archive 文件夾下讀取
product_list=$(ls archives/ios_devices.xcarchive/Products/Library/Frameworks)
for file_name in $product_list
do
    full_product_name=$file_name
    break
done

# 讀取不到就從 showBuildSettings 讀取
if [ -z "$full_product_name" ] || [ "$full_product_name" = "" ]; then
    name_dict=$(xcodebuild -showBuildSettings | grep FULL_PRODUCT_NAME)
    full_product_name=${name_dict#*= }
fi

product_name=${full_product_name%.*}

xcodebuild -create-xcframework \
    -framework archives/ios_devices.xcarchive/Products/Library/Frameworks/"$full_product_name" \
    -framework archives/ios_simulators.xcarchive/Products/Library/Frameworks/"$full_product_name" \
    -output build/"$product_name".xcframework

轉(zhuǎn)載自：https://juejin.cn/post/6914611376560275470