最近開(kāi)發(fā)SDK時(shí)在項(xiàng)目中使用靜態(tài)庫(kù)的時(shí)候都會(huì)有兩個(gè)版本,一個(gè)用于模擬器,一個(gè)用于真機(jī),這樣就比較麻煩。為了模擬器與真機(jī)之間切換調(diào)試的方便,需要制作通用版的Framework交叉包。
根據(jù)Build時(shí)選擇的機(jī)器類(lèi)型,會(huì)分為模擬器Framework和真機(jī)Framework,兩者是不能混用的。此時(shí)可以通過(guò)配置一個(gè)Run Script,在Script中使用lipo命令來(lái)合并兩個(gè)版本的Framework,重新生成一個(gè)新的Framework,這個(gè)Framework將同時(shí)支持在模擬器和真機(jī)上運(yùn)行。
1、檢查Framework包信息
這個(gè)兩個(gè)目錄下包含了生成的Framework文件夾,第一個(gè)是真機(jī)、第二個(gè)是模擬器(當(dāng)前使用的是Debug模式,也可以使用Release模式)。按照預(yù)期:真機(jī)的包是顯示armv7 arm64 架構(gòu)的,模擬器的包是顯示x86_64架構(gòu)的。
現(xiàn)在我們分別對(duì)這兩個(gè)目錄中的Framework進(jìn)行檢測(cè):
1)、Debug-iphoneos(真機(jī))目錄下的Framework:
MiniPC:~ lijl$ lipo -info /Users/lijl/Library/Developer/Xcode/DerivedData/SwiftCommon-dyhotzllcfgqjibahyytumthguvh/Build/Products/Debug-iphoneos/SwiftCommon.framework/SwiftCommon
Architectures in the fat file: /Users/lijl/Library/Developer/Xcode/DerivedData/SwiftCommon-dyhotzllcfgqjibahyytumthguvh/Build/Products/Debug-iphoneos/SwiftCommon.framework/SwiftCommon are: armv7 arm64
MiniPC:~ lijl$
//注:Framework是文件夾,命令再往下一層,使用SDK的二進(jìn)制文件
真機(jī)Framework的結(jié)果是:armv7 arm64??梢?jiàn),如果把這個(gè)Framework運(yùn)行在模擬器中,肯定會(huì)報(bào)錯(cuò),因?yàn)槟M器架構(gòu)是x86_64的。
2)、Debug-iphonesimulator(模擬器)目錄下的Framework:
MiniPC:~ lijl$ lipo -info /Users/lijl/Library/Developer/Xcode/DerivedData/SwiftCommon-dyhotzllcfgqjibahyytumthguvh/Build/Products/Debug-iphonesimulator/SwiftCommon.framework/SwiftCommon
Non-fat file: /Users/lijl/Library/Developer/Xcode/DerivedData/SwiftCommon-dyhotzllcfgqjibahyytumthguvh/Build/Products/Debug-iphonesimulator/SwiftCommon.framework/SwiftCommon is architecture: x86_64
MiniPC:~ lijl$
模擬器Framework的結(jié)果是x86_64??梢?jiàn)這個(gè)庫(kù)只能運(yùn)行在模擬器中,真機(jī)設(shè)備是無(wú)法運(yùn)行的。
2、創(chuàng)建腳本打交叉包
接下來(lái),我們要對(duì)這2個(gè)庫(kù)(其實(shí)是Framework目錄下2個(gè)可執(zhí)行文件)進(jìn)行合并。
在項(xiàng)目的Build Phases中,新建一個(gè)Run Script,輸入下面內(nèi)容:
if [ "${ACTION}" = "build" ]
then
INSTALL_DIR=${SRCROOT}/Products/${PROJECT_NAME}.framework
DEVICE_DIR=${BUILD_ROOT}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework
SIMULATOR_DIR=${BUILD_ROOT}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework
if [ -d "${INSTALL_DIR}" ]
then
rm -rf "${INSTALL_DIR}"
fi
mkdir -p "${INSTALL_DIR}"
cp -R "${DEVICE_DIR}/" "${INSTALL_DIR}/"
#ditto "${DEVICE_DIR}/Headers" "${INSTALL_DIR}/Headers"
lipo -create "${DEVICE_DIR}/${PROJECT_NAME}" "${SIMULATOR_DIR}/${PROJECT_NAME}" -output "${INSTALL_DIR}/${PROJECT_NAME}"
#open "${DEVICE_DIR}"
#open "${SRCROOT}/Products"
fi
經(jīng)過(guò)很多測(cè)試,下面這個(gè)修改后的Run Script會(huì)更加通用,不會(huì)出錯(cuò),唯一報(bào)錯(cuò)的原因是對(duì)應(yīng)目錄下的包沒(méi)有生成,這段shell代碼其實(shí)很簡(jiǎn)單,前面一大部分是申明一些目錄路徑,最后使用lipo命令進(jìn)行合并操作。
3、創(chuàng)建聚合Target生成的交叉包
1、創(chuàng)建target,選擇Other下的Aggregate
2、嵌入腳本。選中剛剛創(chuàng)建的Aggregate,然后選中右側(cè)的Build Phases,點(diǎn)擊左下方加號(hào),選擇New Run Script Phase。
3、新建腳本:
# define output folder environment variable
CONFIGURATION=Release
UNIVERSAL_OUTPUTFOLDER_NATIVE=${SRCROOT}/${CONFIGURATION}-build/${PROJECT_NAME}.framework
#build support native API
# Step 1. Build Device and Simulator versions
cd "${SRCROOT}/.."
xcodebuild build -workspace ${PROJECT_NAME}.xcworkspace -scheme ${PROJECT_NAME} ONLY_ACTIVE_ARCH=NO -configuration ${CONFIGURATION_RN} -sdk iphoneos BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}"
xcodebuild build -workspace ${PROJECT_NAME}.xcworkspace -scheme ${PROJECT_NAME} -configuration ${CONFIGURATION} -sdk iphonesimulator VALID_ARCHS="i386 x86_64" BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}"
# make sure the output directory exists
rm -rf "${SRCROOT}/${CONFIGURATION}-build"
mkdir -p "${SRCROOT}/${CONFIGURATION}-build"
cp -R "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework/" "${UNIVERSAL_OUTPUTFOLDER_NATIVE}/"
# Step 2. Create universal binary file using lipo
lipo -create "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework/${PROJECT_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework/${PROJECT_NAME}" -output "${UNIVERSAL_OUTPUTFOLDER_NATIVE}/${PROJECT_NAME}"
# Last touch. copy the header files. Just for convenience
補(bǔ)充更新,兼容xcode13:
# Type a script or drag a script file from your workspace to insert its path.
# 1、定義輸出變量
### 定義workspace名稱(chēng)
WORKSPACE= xxx1
### 定義輸出SDK名稱(chēng)
SDKTARGET=xxxSDK
### 定義輸出資源包名稱(chēng)
BUNDLETARGET=xxxResources
### 定義編譯模式
CONFIGURATION=Release
### 定義輸出文件夾
PRODUCTS_OUTPUTFOLDER=${SRCROOT}/../Products
# 2、 先清理 TARGETS
#xcodebuild clean -target ${SDKTARGET}
#xcodebuild clean -target ${BUNDLETARGET}
cd "${SRCROOT}/.."
# 3、 執(zhí)行編譯SDK TARGETS
xcodebuild -workspace ${WORKSPACE}.xcworkspace -scheme ${SDKTARGET} ONLY_ACTIVE_ARCH=NO -configuration ${CONFIGURATION} -sdk iphoneos BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" -UseModernBuildSystem=NO
xcodebuild -workspace ${WORKSPACE}.xcworkspace -scheme ${SDKTARGET} -configuration ${CONFIGURATION} -sdk iphonesimulator VALID_ARCHS="i386 x86_64" BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" -UseModernBuildSystem=NO
# 4、 執(zhí)行編譯資源 TARGETS
xcodebuild -workspace ${WORKSPACE}.xcworkspace -scheme ${BUNDLETARGET} ONLY_ACTIVE_ARCH=NO -configuration ${CONFIGURATION} -sdk iphoneos BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" -UseModernBuildSystem=NO
xcodebuild -workspace ${WORKSPACE}.xcworkspace -scheme ${BUNDLETARGET} -configuration ${CONFIGURATION} -sdk iphonesimulator BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" -UseModernBuildSystem=NO
# 5、 清空輸出指定文件夾、創(chuàng)建新文件夾
rm -rf "${PRODUCTS_OUTPUTFOLDER}"
mkdir -p "${PRODUCTS_OUTPUTFOLDER}"
# 6、 將編譯好的SDK和資源BUNDLE拷貝到指定輸出文件夾
cp -R "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${SDKTARGET}.framework" "${PRODUCTS_OUTPUTFOLDER}/"
cp -R "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${BUNDLETARGET}.bundle" "${PRODUCTS_OUTPUTFOLDER}/"
rm "${PRODUCTS_OUTPUTFOLDER}/${BUNDLETARGET}.bundle/${BUNDLETARGET}"
rm "${PRODUCTS_OUTPUTFOLDER}/${BUNDLETARGET}.bundle/Info.plist"
# 7、 合成真機(jī)和摸機(jī)器指令包
lipo -create "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${SDKTARGET}.framework/${SDKTARGET}" "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${SDKTARGET}.framework/${SDKTARGET}" -output "${PRODUCTS_OUTPUTFOLDER}/${SDKTARGET}.framework/${SDKTARGET}"
# 8、 打開(kāi)輸出文件夾
open ${PRODUCTS_OUTPUTFOLDER}
4、驗(yàn)證腳本生成的交叉包
現(xiàn)在,當(dāng)項(xiàng)目再次Build時(shí),就會(huì)在項(xiàng)目目錄下面出現(xiàn)Products目錄,里面包含了合并后的Framework文件夾。使用lipo -info來(lái)檢測(cè)下:
1、打開(kāi)終端,進(jìn)入到你的FrameWork,cd xxxx/xxx.framework
2、查看架構(gòu)支持,lipo -info xxxx/xxx.framework/xxx (注意:xxx是你的FrameWork名稱(chēng))
MiniPC:~ lijl$ lipo -info /Users/lijl/Documents/Self\ Project/Cocoa\ Touch\ Framework/SwiftCommon/Products/SwiftCommon.framework/SwiftCommon
運(yùn)行之后:
Architectures in the fat file: /Users/lijl/Documents/Self Project/Cocoa Touch Framework/SwiftCommon/Products/SwiftCommon.framework/SwiftCommon are: x86_64 armv7 arm64
MiniPC:~ lijl$
信息顯示成功的集成了 x86_64 armv7 arm64 ,這樣就生成了真機(jī)與模擬器通用的交叉包
附指令集:
設(shè)備的CPU架構(gòu)(指令集):
模擬器:
iPhone 4s~5: i386
iPhone 5s~最新: x86_64
真機(jī)(iOS設(shè)備):
armv6: iPhone、iPhone 2、iPhone 3G、iPod Touch(第一代)、iPod Touch(第二代)
armv7: iPhone 3Gs、iPhone 4、iPhone 4s、iPad、iPad 2
armv7s: iPhone 5、iPhone 5c
arm64: iPhone 5s、iPhone 6、iPhone 6 Plus、iPhone 6s、iPhone 6s Plus、iPad Air、iPad Air2、iPad mini2、iPad mini3,以及最新的機(jī)型。