使用Xcode和SDK 4+构建胖静态库(设备+模拟器)

Question

从理论上讲,我们可以构建一个包含模拟器,iPhone和iPad的静态库.

但是,Apple没有关于此的文档,我可以找到,并且Xcode的默认模板未配置为执行此操作.

我正在寻找一种可以在Xcode中完成的简单,可移植,可重用的技术.

一些历史:

• 在2008年,我们曾经能够制作包含sim和设备的单个静态库.Apple禁用了那个.
• 在整个2009年,我们制作了一对静态库 - 一个用于sim,一个用于设备.Apple现在也禁用了它.

参考文献:

1. 这是一个好主意,它是一种很好的方法,但它不起作用:http://www.drobnik.com/touch/2010/04/universal-static-libraries/

   • 他的脚本中有一些错误意味着它只适用于他的机器 - 他应该使用BUILT_PRODUCTS_DIR和/或BUILD_DIR而不是"猜测"它们)
   • Apple的最新Xcode阻止你做他做的事情 - 由于Xcode处理目标的方式(记录)改变,它根本不起作用)

2. 另一个提问者询问如何在不使用xcode的情况下执行此操作,以及专注于arm6与arm7部分的响应 - 但忽略了i386部分:如何为armv6,armv7和i386编译静态库(fat)

   • 由于Apple的最新变化,模拟器部分与arm6/arm7的区别不再相同 - 这是一个不同的问题,见上文)

Answer 1

备择方案:

轻松复制/粘贴最新版本(但安装说明可能会更改 - 请参阅下文!)

Karl的库需要花费更多精力来设置,但更好的长期解决方案(它将您的库转换为框架).

使用它,然后调整它以添加对Archive构建的支持 - cf @ Frederik在下面评论他正在使用的更改,使其与存档模式很好地协同工作.

最近的变化:1.增加了对iOS 10.x的支持(同时保持对旧平台的支持)

1. 关于如何将这个脚本与项目嵌入到另一个项目中使用的信息(虽然我强烈建议不要这样做,但是 - 如果你将项目嵌入到Xcode中,那么Apple会在Xcode中出现一些显示阻止错误3.x到Xcode 4.6.x)

2. Bonus脚本让你自动包含Bundles(即包括来自你库的PNG文件,PLIST文件等) - 见下文(滚动到底部)

3. 现在支持iPhone5(使用Apple的解决方案来解决lipo中的错误).注意:安装说明已更改(我可以通过以后更改脚本来简化此操作,但现在不想冒风险)

4. "copy headers"部分现在尊重公共标题位置的构建设置(由Frederik Wallner提供)

5. 添加了SYMROOT的显式设置(也可能需要设置OBJROOT？),感谢Doug Dickinson

SCRIPT(这是你必须复制/粘贴的东西)

有关使用/安装说明,请参阅下文

##########################################
#
# 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

安装说明

1. 创建一个静态lib项目
2. 选择目标
3. 在"构建设置"选项卡中,将"仅构建活动体系结构"设置为"否"(对于所有项目)
4. 在"Build Phases"选项卡中,选择"Add ... New Build Phase ... New Run Script Build Phase"
5. 将脚本(上方)复制/粘贴到框中

...奖金可选用法:

5. 可选:如果您的库中有标题,请将它们添加到"复制标题"阶段
6. 可选:...并将它们从"项目"部分拖放到"公共"部分
7. 可选:......每次构建应用程序时,它们都会自动导出到"debug-universal"目录的子目录中(它们将在usr/local/include中)
8. 可选:注意:如果您还尝试将项目拖放到另一个Xcode项目中,这会暴露Xcode 4中的错误,如果您在拖放项目中有公共标题,则无法创建.IPA文件.解决方法:不要嵌入xcode项目(Apple的代码中有太多错误!)

如果找不到输出文件,这是一个解决方法:

1. 将以下代码添加到脚本的最后(由Frederik Wallner提供):打开"$ {CREATING_UNIVERSAL_DIR}"

2. Apple删除200行后的所有输出.选择目标,在运行脚本阶段,您必须取消选中:"在构建日志中显示环境变量"

3. 如果你正在为XCode4使用自定义的"构建输出"目录,那么XCode会将所有"意外"文件放在错误的位置.

   1. 建立项目
   2. 单击右侧最后一个图标,位于Xcode4的左上角区域.
   3. 选择顶部项目(这是您的"最新版本".Apple应自动选择它,但他们没有想到这一点)
   4. 在主窗口中,滚动到底部.最后一行应该是:lipo:用于当前配置(Debug)创建输出文件:/Users/blah/Library/Developer/Xcode/DerivedData/AppName-ashwnbutvodmoleijzlncudsekyf/Build/Products/Debug-universal/libTargetName.a

   ......这是Universal Build的位置.

如何在项目中包含"非源代码"文件(PNG,PLIST,XML等)

1. 做上面的一切,检查它的工作原理
2. 在第一个之后创建一个新的运行脚本阶段(复制/粘贴下面的代码)
3. 在Xcode中创建一个类型为"bundle"的新Target
4. 在您的MAIN PROJECT中,在"Build Phases"中,将新包添加为"依赖于"(顶部,点击加号按钮,滚动到底部,找到产品中的".bundle"文件)
5. 在新的捆绑目标中,在"构建阶段"中,添加"复制捆绑资源"部分,并将所有PNG文件拖放到其中

用于将构建的包自动复制到与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}"

Answer 2

我花了很多时间尝试构建一个可以在armv7,armv7s和模拟器上运行的胖静态库.终于找到了解决方案.

要点是分别构建两个库(一个用于设备,一个用于模拟器),重命名它们以相互区分,然后将它们创建为一个库.

lipo -create libPhone.a libSimulator.a -output libUniversal.a

我尝试了它,它的工作原理!

Answer 3

我已经制作了一个XCode 4项目模板,可以像制作常规库一样轻松地创建通用框架.

Answer 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中尝试了很多配置,但没有任何效果.由于这是一种批处理,因此命令行设计更为合适,因此Apple逐渐从Xcode中删除了批量构建功能.所以我不希望他们将来提供基于UI的批量构建功能.

Answer 5

我需要一个用于JsonKit的胖静态库,因此在Xcode中创建了一个静态lib项目,然后在项目目录中运行这个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

Answer 6

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\}$')