[英]Build fat static library (device + simulator) using Xcode and SDK 4+
从理论上讲,我们似乎可以构建一个包含模拟器、iPhone 和 iPad 的静态库。
但是,Apple 没有我可以找到的关于此的文档,并且 Xcode 的默认模板未配置为执行此操作。
我正在寻找一种可以在 Xcode 中完成的简单、便携、可重用的技术。
一些历史:
参考:
这是一个好主意,它是一个很好的方法,但它不起作用: http : //www.drobnik.com/touch/2010/04/universal-static-libraries/
另一个 SO 提问者询问如何在没有 xcode 的情况下做到这一点,并且回答侧重于 arm6 与 arm7 部分 - 但忽略了 i386 部分: 如何为 armv6、armv7 和 i386 编译静态库(胖)
备择方案:
轻松复制/粘贴最新版本(但安装说明可能会更改 - 见下文!)
Karl 的库需要更多的努力来设置,但更好的长期解决方案(它将您的库转换为框架)。
使用它,然后调整它以添加对存档构建的支持- 参见下面@Frederik 对他使用的更改的评论,以使其在存档模式下可以很好地工作。
最近的变化: 1. 添加了对 iOS 10.x 的支持(同时保持对旧平台的支持)
关于如何将这个脚本与嵌入在另一个项目中的项目一起使用的信息(尽管我强烈建议不要这样做,但如果您将项目从 Xcode 相互嵌入,Apple 在 Xcode 中有几个显示停止错误3.x 到 Xcode 4.6.x)
奖励脚本让您自动包含捆绑包(即包含库中的 PNG 文件、PLIST 文件等!) - 见下文(滚动到底部)
现在支持 iPhone5(使用 Apple 解决 lipo 中的错误的方法)。 注意:安装说明已更改(我可能可以通过将来更改脚本来简化此操作,但现在不想冒险)
“复制标题”部分现在尊重公共标题位置的构建设置(由 Frederik Wallner 提供)
添加了 SYMROOT 的显式设置(也许还需要设置 OBJROOT?),感谢 Doug Dickinson
脚本(这是您必须复制/粘贴的内容)
有关使用/安装说明,请参见下文
##########################################
#
# c.f. https://stackoverflow.com/questions/3520977/build-fat-static-library-device-simulator-using-xcode-and-sdk-4
#
# Version 2.82
#
# Latest Change:
# - MORE tweaks to get the iOS 10+ and 9- working
# - Support iOS 10+
# - Corrected typo for iOS 1-10+ (thanks @stuikomma)
#
# Purpose:
# Automatically create a Universal static library for iPhone + iPad + iPhone Simulator from within XCode
#
# Author: Adam Martin - http://twitter.com/redglassesapps
# Based on: original script from Eonil (main changes: Eonil's script WILL NOT WORK in Xcode GUI - it WILL CRASH YOUR COMPUTER)
#
set -e
set -o pipefail
#################[ Tests: helps workaround any future bugs in Xcode ]########
#
DEBUG_THIS_SCRIPT="false"
if [ $DEBUG_THIS_SCRIPT = "true" ]
then
echo "########### TESTS #############"
echo "Use the following variables when debugging this script; note that they may change on recursions"
echo "BUILD_DIR = $BUILD_DIR"
echo "BUILD_ROOT = $BUILD_ROOT"
echo "CONFIGURATION_BUILD_DIR = $CONFIGURATION_BUILD_DIR"
echo "BUILT_PRODUCTS_DIR = $BUILT_PRODUCTS_DIR"
echo "CONFIGURATION_TEMP_DIR = $CONFIGURATION_TEMP_DIR"
echo "TARGET_BUILD_DIR = $TARGET_BUILD_DIR"
fi
#####################[ part 1 ]##################
# First, work out the BASESDK version number (NB: Apple ought to report this, but they hide it)
# (incidental: searching for substrings in sh is a nightmare! Sob)
SDK_VERSION=$(echo ${SDK_NAME} | grep -o '\d\{1,2\}\.\d\{1,2\}$')
# Next, work out if we're in SIM or DEVICE
if [ ${PLATFORM_NAME} = "iphonesimulator" ]
then
OTHER_SDK_TO_BUILD=iphoneos${SDK_VERSION}
else
OTHER_SDK_TO_BUILD=iphonesimulator${SDK_VERSION}
fi
echo "XCode has selected SDK: ${PLATFORM_NAME} with version: ${SDK_VERSION} (although back-targetting: ${IPHONEOS_DEPLOYMENT_TARGET})"
echo "...therefore, OTHER_SDK_TO_BUILD = ${OTHER_SDK_TO_BUILD}"
#
#####################[ end of part 1 ]##################
#####################[ part 2 ]##################
#
# IF this is the original invocation, invoke WHATEVER other builds are required
#
# Xcode is already building ONE target...
#
# ...but this is a LIBRARY, so Apple is wrong to set it to build just one.
# ...we need to build ALL targets
# ...we MUST NOT re-build the target that is ALREADY being built: Xcode WILL CRASH YOUR COMPUTER if you try this (infinite recursion!)
#
#
# So: build ONLY the missing platforms/configurations.
if [ "true" == ${ALREADYINVOKED:-false} ]
then
echo "RECURSION: I am NOT the root invocation, so I'm NOT going to recurse"
else
# CRITICAL:
# Prevent infinite recursion (Xcode sucks)
export ALREADYINVOKED="true"
echo "RECURSION: I am the root ... recursing all missing build targets NOW..."
echo "RECURSION: ...about to invoke: xcodebuild -configuration \"${CONFIGURATION}\" -project \"${PROJECT_NAME}.xcodeproj\" -target \"${TARGET_NAME}\" -sdk \"${OTHER_SDK_TO_BUILD}\" ${ACTION} RUN_CLANG_STATIC_ANALYZER=NO" BUILD_DIR=\"${BUILD_DIR}\" BUILD_ROOT=\"${BUILD_ROOT}\" SYMROOT=\"${SYMROOT}\"
xcodebuild -configuration "${CONFIGURATION}" -project "${PROJECT_NAME}.xcodeproj" -target "${TARGET_NAME}" -sdk "${OTHER_SDK_TO_BUILD}" ${ACTION} RUN_CLANG_STATIC_ANALYZER=NO BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" SYMROOT="${SYMROOT}"
ACTION="build"
#Merge all platform binaries as a fat binary for each configurations.
# Calculate where the (multiple) built files are coming from:
CURRENTCONFIG_DEVICE_DIR=${SYMROOT}/${CONFIGURATION}-iphoneos
CURRENTCONFIG_SIMULATOR_DIR=${SYMROOT}/${CONFIGURATION}-iphonesimulator
echo "Taking device build from: ${CURRENTCONFIG_DEVICE_DIR}"
echo "Taking simulator build from: ${CURRENTCONFIG_SIMULATOR_DIR}"
CREATING_UNIVERSAL_DIR=${SYMROOT}/${CONFIGURATION}-universal
echo "...I will output a universal build to: ${CREATING_UNIVERSAL_DIR}"
# ... remove the products of previous runs of this script
# NB: this directory is ONLY created by this script - it should be safe to delete!
rm -rf "${CREATING_UNIVERSAL_DIR}"
mkdir "${CREATING_UNIVERSAL_DIR}"
#
echo "lipo: for current configuration (${CONFIGURATION}) creating output file: ${CREATING_UNIVERSAL_DIR}/${EXECUTABLE_NAME}"
xcrun -sdk iphoneos lipo -create -output "${CREATING_UNIVERSAL_DIR}/${EXECUTABLE_NAME}" "${CURRENTCONFIG_DEVICE_DIR}/${EXECUTABLE_NAME}" "${CURRENTCONFIG_SIMULATOR_DIR}/${EXECUTABLE_NAME}"
#########
#
# Added: StackOverflow suggestion to also copy "include" files
# (untested, but should work OK)
#
echo "Fetching headers from ${PUBLIC_HEADERS_FOLDER_PATH}"
echo " (if you embed your library project in another project, you will need to add"
echo " a "User Search Headers" build setting of: (NB INCLUDE THE DOUBLE QUOTES BELOW!)"
echo ' "$(TARGET_BUILD_DIR)/usr/local/include/"'
if [ -d "${CURRENTCONFIG_DEVICE_DIR}${PUBLIC_HEADERS_FOLDER_PATH}" ]
then
mkdir -p "${CREATING_UNIVERSAL_DIR}${PUBLIC_HEADERS_FOLDER_PATH}"
# * needs to be outside the double quotes?
cp -r "${CURRENTCONFIG_DEVICE_DIR}${PUBLIC_HEADERS_FOLDER_PATH}"* "${CREATING_UNIVERSAL_DIR}${PUBLIC_HEADERS_FOLDER_PATH}"
fi
fi
安装说明
...奖金可选用法:
如果找不到输出文件,这里有一个解决方法:
将以下代码添加到脚本的最后(由 Frederik Wallner 提供):打开“${CREATING_UNIVERSAL_DIR}”
Apple 删除 200 行后的所有输出。 选择您的目标,在运行脚本阶段,您必须取消勾选:“在构建日志中显示环境变量”
如果您使用 XCode4 的自定义“构建输出”目录,则 XCode 会将所有“意外”文件放在错误的位置。
...那是您的通用构建的位置。
如何在项目中包含“非源代码”文件(PNG、PLIST、XML 等)
将构建的包自动复制到与 FAT 静态库相同的文件夹中的脚本:
echo "RunScript2:"
echo "Autocopying any bundles into the 'universal' output folder created by RunScript1"
CREATING_UNIVERSAL_DIR=${SYMROOT}/${CONFIGURATION}-universal
cp -r "${BUILT_PRODUCTS_DIR}/"*.bundle "${CREATING_UNIVERSAL_DIR}"
我花了很多时间试图构建一个可以在 armv7、armv7s 和模拟器上运行的胖静态库。 终于找到了解决办法。
要点是分别构建两个库(一个用于设备,一个用于模拟器),重命名它们以区分彼此,然后 lipo -create 它们到一个库中。
lipo -create libPhone.a libSimulator.a -output libUniversal.a
我试过了,它有效!
我制作了一个XCode 4 项目模板,让您可以像制作常规库一样轻松制作通用框架。
有一个命令行实用程序xcodebuild
,您可以在 xcode 中运行 shell 命令。 因此,如果您不介意使用自定义脚本,此脚本可能会对您有所帮助。
#Configurations.
#This script designed for Mac OS X command-line, so does not use Xcode build variables.
#But you can use it freely if you want.
TARGET=sns
ACTION="clean build"
FILE_NAME=libsns.a
DEVICE=iphoneos3.2
SIMULATOR=iphonesimulator3.2
#Build for all platforms/configurations.
xcodebuild -configuration Debug -target ${TARGET} -sdk ${DEVICE} ${ACTION} RUN_CLANG_STATIC_ANALYZER=NO
xcodebuild -configuration Debug -target ${TARGET} -sdk ${SIMULATOR} ${ACTION} RUN_CLANG_STATIC_ANALYZER=NO
xcodebuild -configuration Release -target ${TARGET} -sdk ${DEVICE} ${ACTION} RUN_CLANG_STATIC_ANALYZER=NO
xcodebuild -configuration Release -target ${TARGET} -sdk ${SIMULATOR} ${ACTION} RUN_CLANG_STATIC_ANALYZER=NO
#Merge all platform binaries as a fat binary for each configurations.
DEBUG_DEVICE_DIR=${SYMROOT}/Debug-iphoneos
DEBUG_SIMULATOR_DIR=${SYMROOT}/Debug-iphonesimulator
DEBUG_UNIVERSAL_DIR=${SYMROOT}/Debug-universal
RELEASE_DEVICE_DIR=${SYMROOT}/Release-iphoneos
RELEASE_SIMULATOR_DIR=${SYMROOT}/Release-iphonesimulator
RELEASE_UNIVERSAL_DIR=${SYMROOT}/Release-universal
rm -rf "${DEBUG_UNIVERSAL_DIR}"
rm -rf "${RELEASE_UNIVERSAL_DIR}"
mkdir "${DEBUG_UNIVERSAL_DIR}"
mkdir "${RELEASE_UNIVERSAL_DIR}"
lipo -create -output "${DEBUG_UNIVERSAL_DIR}/${FILE_NAME}" "${DEBUG_DEVICE_DIR}/${FILE_NAME}" "${DEBUG_SIMULATOR_DIR}/${FILE_NAME}"
lipo -create -output "${RELEASE_UNIVERSAL_DIR}/${FILE_NAME}" "${RELEASE_DEVICE_DIR}/${FILE_NAME}" "${RELEASE_SIMULATOR_DIR}/${FILE_NAME}"
也许看起来效率低下(我不擅长 shell 脚本),但很容易理解。 我配置了一个仅运行此脚本的新目标。 该脚本是为命令行设计的,但未在 :) 中进行测试
核心概念是xcodebuild
和lipo
。
我在 Xcode UI 中尝试了许多配置,但没有任何效果。 因为这是一种批处理,所以命令行设计更适合,所以苹果逐渐从 Xcode 中删除了批处理构建功能。 所以我不希望他们将来提供基于 UI 的批量构建功能。
我需要一个用于 JsonKit 的静态库,所以在 Xcode 中创建了一个静态库项目,然后在项目目录中运行这个 bash 脚本。 只要您在关闭“仅构建活动配置”的情况下配置了 xcode 项目,您就应该在一个库中获得所有架构。
#!/bin/bash
xcodebuild -sdk iphoneos
xcodebuild -sdk iphonesimulator
lipo -create -output libJsonKit.a build/Release-iphoneos/libJsonKit.a build/Release-iphonesimulator/libJsonKit.a
IOS 10 更新:
我在用 iphoneos10.0 构建 fatlib 时遇到了问题,因为脚本中的正则表达式只需要 9.x 及更低版本,而对于 ios 10.0 则返回 0.0
要解决这个问题,只需更换
SDK_VERSION=$(echo ${SDK_NAME} | grep -o '.\{3\}$')
和
SDK_VERSION=$(echo ${SDK_NAME} | grep -o '[\\.0-9]\{3,4\}$')
我已经把它变成了一个Xcode 4 模板,与 Karl 的静态框架模板一样。
我发现由于明显的链接器错误,构建静态框架(而不是普通静态库)会导致 LLVM 随机崩溃 - 所以,我猜静态库仍然有用!
XCode 12 更新:
如果您在没有-arch
参数的情况下运行xcodebuild
,XCode 12 将构建默认架构为“arm64 x86_64”的模拟器库。
然后运行xcrun -sdk iphoneos lipo -create -output
会冲突,因为模拟器和设备库中存在arm64
架构。
我从 Adam git 中 fork 脚本并修复它。
很好! 我将类似的东西拼凑在一起,但不得不单独运行。 将它作为构建过程的一部分使它变得更加简单。
注意事项之一。 我注意到它不会复制您标记为公开的任何包含文件。 我已经将我的脚本中的内容改编为您的脚本,并且效果很好。 将以下内容粘贴到脚本的末尾。
if [ -d "${CURRENTCONFIG_DEVICE_DIR}/usr/local/include" ]
then
mkdir -p "${CURRENTCONFIG_UNIVERSAL_DIR}/usr/local/include"
cp "${CURRENTCONFIG_DEVICE_DIR}"/usr/local/include/* "${CURRENTCONFIG_UNIVERSAL_DIR}/usr/local/include"
fi
我实际上只是为此目的编写了自己的脚本。 它不使用 Xcode。 (它基于 Gambit Scheme 项目中的类似脚本。)
基本上,它运行 ./configure 并 make 三次(对于 i386、armv7 和 armv7s),并将每个生成的库组合到一个胖库中。
从 21 年 10 月 22 日起,我采用了最新 Xcode 的公认答案脚本,并添加了对 .framework 和新 .XCFrameworks 的支持,以及更完整的 Objective-C 标头复制。
https://github.com/Talking-App-Kit/Useful/blob/main/BuildFatPackage.sh
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.