XCFramework簡介
XCFramework是XCode11中提出的一個新特性,是由XCode創建的一個可分發的二進制包,它包含了 framework 或 library 的一個或多個變體,因此可以在多個平臺(iOS、macOS、tvOS、watchOS) 上使用,包括模擬器。XCFramework 可以是靜態的,也可以是動態的。xcframework 的好處就是用 Xcode 發布的時候,Xcode 會自動選用正確的指令集 Frameworks,省去了手動移除動態庫中的模擬器指令集的工作。
作用
- 包含模擬器和真機
- 包含多個平臺:xcframework 支持所有的蘋果平臺,iOS,macOS,tvOS,watchOS,iPadOS,carPlayOS
- 可以包含其他第三方的庫
- 可以不用設置復雜的頭文件路徑
- 可以在庫里面設置權限
- 二進制的穩定性
XCFramework的結構
創建包含iOS真機、模擬器和MacOS的XCFramework
為所需平臺歸檔
iOS模擬器
xcodebuild -workspace "$WORKSPACE_NAME.xcworkspace"\
-scheme "$FRAMEWORK_NAME" -configuration "Release"\
-sdk "iphonesimulator"\
-arch i386 -arch x86_64 \
-derivedDataPath "build/derivedData"\
-archivePath "./build/simulator.xcarchive"\
SKIP_INSTALL=NO BUILD_LIBRARIES_FOR_DISTRIBUTION=YES
iOS真機
xcodebuild -workspace "$WORKSPACE_NAME.xcworkspace"\
-scheme "$FRAMEWORK_NAME"\
-arch armv7 -arch armv7s -arch arm64 \
-configuration "Release"\
-sdk "iphoneos"\
-derivedDataPath "build/derivedData"\
-archivePath "./build/ios.xcarchive"\
SKIP_INSTALL=NO BUILD_LIBRARIES_FOR_DISTRIBUTION=YES
MacOS
xcodebuild -workspace "$WORKSPACE_NAME.xcworkspace"\
-scheme "$FRAMEWORK_NAME"\
-configuration "Release"\
-destination 'platform=macOS,arch=x86_64,variant=Mac Catalyst'\
-sdk "$MAC_OS"\
-derivedDataPath "build/derivedData"\
-archivePath "./build/catalyst.xcarchive"\
BUILD_LIBRARIES_FOR_DISTRIBUTION=YES SUPPORTS_MACCATALYST=YES SKIP_INSTALL=NO clean
由.a靜態庫創建Framework
iOS模擬器
# 創建simulator framework
PRODUCT_DIR=Products
BUILD_PRODUCTS_PATH="./build/derivedData/Build/Products"
SIMULATOR_FRAMEWORK_PATH="${BUILD_PRODUCTS_PATH}/Release-iphonesimulator/libBuglyOAUpgrade.a"
SIMULATOR_HEADERS="${BUILD_PRODUCTS_PATH}/Release-iphonesimulator/include/${FRAMEWORK_NAME}"
SIMULATOR_FRAMEWORK="${PRODUCT_DIR}/${FRAMEWORK_NAME}/simulator/${FRAMEWORK_NAME}.framework"
mkdir -p ${SIMULATOR_FRAMEWORK}/Headers
lipo -create ${SIMULATOR_FRAMEWORK_PATH} -output ${SIMULATOR_FRAMEWORK}/${FRAMEWORK_NAME}
cp -R ${SIMULATOR_HEADERS}/* ${SIMULATOR_FRAMEWORK}/Headers/
iOS真機
# 創建真機 framework
PRODUCT_DIR=Products
BUILD_PRODUCTS_PATH="./build/derivedData/Build/Products"
IOS_FRAMEWORK_PATH="${BUILD_PRODUCTS_PATH}/Release-iphoneos/libBuglyOAUpgrade.a"
IOS_HEEADERS="${BUILD_PRODUCTS_PATH}/Release-iphoneos/include/${FRAMEWORK_NAME}"
IPHONE_FRAMEWORK="${PRODUCT_DIR}/${FRAMEWORK_NAME}/iphoneos/${FRAMEWORK_NAME}.framework"
mkdir -p ${IPHONE_FRAMEWORK}/Headers
lipo -create ${IOS_FRAMEWORK_PATH} -output ${IPHONE_FRAMEWORK}/${FRAMEWORK_NAME}
cp -R ${IOS_HEEADERS}/* ${IPHONE_FRAMEWORK}/Headers/
MacOS
# 創建mac-catalyst framework
PRODUCT_DIR=Products
BUILD_PRODUCTS_PATH="./build/derivedData/Build/Products"
CATALYST_FRAMEWORK_PATH="${BUILD_PRODUCTS_PATH}/Release-maccatalyst/libBuglyOAUpgrade.a"
CATALYST_HEADERS="${BUILD_PRODUCTS_PATH}/Release-maccatalyst/include/${FRAMEWORK_NAME}"
CATALYST_FRAMEWORK="${PRODUCT_DIR}/${FRAMEWORK_NAME}/catalyst/${FRAMEWORK_NAME}.framework"
mkdir -p ${CATALYST_FRAMEWORK}/Headers
lipo -create ${CATALYST_FRAMEWORK_PATH} -output ${CATALYST_FRAMEWORK}/${FRAMEWORK_NAME}
cp -R ${CATALYST_HEADERS}/* ${CATALYST_FRAMEWORK}/Headers/
創建xcframework
xcodebuild -create-xcframework \
-framework ${SIMULATOR_FRAMEWORK} \
-framework ${IPHONE_FRAMEWORK} \
-framework ${CATALYST_FRAMEWORK} \
-output "./$FRAMEWORK_NAME.xcframework"
zip -r XC_FRAMEWORK.zip "./$FRAMEWORK_NAME.xcframework"