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


283

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

但是,Apple没有关于此的文档,我也没有配置Xcode的默认模板。

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

一些历史:

  • 在2008年,我们曾经能够制作同时包含sim和设备的单个静态库。苹果禁用了它。
  • 在整个2009年,我们制作了成对的静态库-一对用于sim库,一对用于设备。苹果现在也禁用了该功能。

参考文献:

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

    • 他的脚本中存在一些错误,这意味着该错误仅适用于他的机器-他应该使用BUILT_PRODUCTS_DIR和/或BUILD_DIR而不是“猜测”它们)
    • Apple最新的Xcode阻止您执行他的工作-由于Xcode处理目标的方式(已记录)的更改,它根本无法工作)
  2. 另一位SO问题询问者询问如何在不使用xcode的情况下执行此操作,而响应的重点是arm6 vs arm7部分-但忽略了i386部分:如何为armv6,armv7和i386编译静态库(fat)

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

只是想知道-您为什么要那样?难道不是设备库更大,设备更重吗?
cregox 2011年

3
@Cawas-库的“重量”在95%的实际情况中无关紧要-对于我们大多数人而言,库很小,尤其是与仅显示一个UIImageView相比。
亚当

1
@Cawas-同时,这里的价值在于您可以使其他人更轻松地使用/重用您的库。它变为一个阶段的拖放过程。
亚当

4
@Cawas-最后,一个令人惊讶的宝贵好处:意外地向某人发送“错误的”编译库很容易 -XCode 会进行零检查,并将“错误的”体系结构愉快地编译到您认为是“正确”的命名文件中建筑。苹果在这一领域一直在打破Xcode的标准 -每个新版本都有变化,这意味着“您昨天按下以正确编译您的lib的按钮今天将错误地编译它”。直到Apple不再把我们弄乱了,我们需要对他们的不良UI进行白痴验证:)。
亚当

1
那真是太好了!因为就目前而言,我们只是不能依靠模拟器来完成更复杂的事情。
cregox 2011年

Answers:


272

备择方案:

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

Karl的库需要花费更多的精力来进行设置,但是要提供更好的长期解决方案(它将您的库转换为Framework)。

使用它,然后对其进行调整以增加对存档版本的支持 -请参阅下面的@Frederik评论,以了解他为使存档模式更好地使用而进行的更改。


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

  1. 有关如何将此脚本与另一个项目中嵌入的项目一起使用的信息(尽管我极力建议您永远不要这样做-如果您将项目相互嵌入Xcode中,Apple会在Xcode中出现一些显示停止的错误3.x到Xcode 4.6.x)

  2. 奖金脚本,可让您自动添加捆绑包(即,从库中包含PNG文件,PLIST文件等!)-参见下文(滚动至底部)

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

  4. “复制标头”部分现在尊重公共标头位置的构建设置(由Frederik Wallner提供)

  5. 由于道格·迪金森(Doug Dickinson),添加了明确的SYMROOT设置(也许也需要设置OBJROOT吗?)


脚本(这是您必须复制/粘贴的内容)

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

##########################################
#
# c.f. /programming/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. 在“构建阶段”选项卡中,选择“添加...新构建阶段...新运行脚本构建阶段”
  5. 将脚本复制/粘贴到框中

...奖励可选用法:

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

如果找不到输出文件,请采用以下解决方法:

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

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

  3. 如果您使用XCode4的自定义“生成输出”目录,则XCode会将所有“意外”文件放在错误的位置。

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

    ...这就是您的通用版本的位置。


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

  1. 完成以上所有操作,检查是否有效
  2. 创建第一个之后的新运行脚本阶段(复制/粘贴以下代码)
  3. 在Xcode中创建一个类型为“ bundle”的新Target
  4. 在您的主项目的“构建阶段”中,将新捆绑包添加为它“依赖”的内容(顶部,单击加号按钮,滚动到底部,在产品中找到“ .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}"

2
我现在已经在一些项目中使用了此工具,并将其运送到使用此工具构建库的应用程序商店中。所有人都可以100%正常工作,所以我现在就坚持使用它(直到Xcode 4为止)
Adam

2
谁能确认此方法是否适用于XCode 4.5?我正在尝试编译静态库并在我的主项目中使用它。我可以在设备上运行此程序,但不能在模拟器上运行它。这是我得到的错误:文件/Users/alex/Documents/iphone/production/iphone/mymedia/libMyUnrar4iOS.a中缺少必需的体系结构i386(2个切片)
Alex1987 2012年

2
知道如何使它与XCode 5和ARM64一起使用吗?如果我将体系结构保留为标准配置,那么它将按预期使armv7,armvs7和i386成为库。如果我将体系结构设置为包括64位的标准,则该库仅包含“ cputype 16777223”。我在.a文件上使用otool -h验证其中的内容
Roger Binns

1
XCode5使添加运行脚本构建阶段变得更加棘手。看看这个: runscriptbuildphase.com
Fabio Napodano

1
这似乎可以在Xcode 6上正常运行,而无需进行任何更改(到目前为止仅尝试了几个项目,并且尚未提交任何App Store更新,但到目前为止一切正常。)
亚当

85

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

要点是分别构建两个库(一个用于设备,然后一个用于模拟器),重命名它们以彼此区分,然后将它们脂质创建到一个库中。

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

我尝试了,它有效!


4
我建议您阅读已接受的答案。您可能会发现它已经被覆盖了2年了……
Adam

2
我读了它,使用了脚本,但是对于armv7s而言,它不适合我。
g_low

2
lipo命令在脚本上不起作用,但是手动操作效果很好!10x
Dima

9
+1这确实是我所需要的,而不是庞大的“制作框架”脚本。
LearnCocos2D 2013年

您的SolutionURL返回“错误404-未找到”
Alex

74

我已经制作了一个XCode 4项目模板,它使您可以像制作常规库一样容易地创建通用框架。


无法使用iOS 4.3目标构建它。得到以下错误:-stdlib = libc ++的无效部署目标(需要iOS 5.0或更高版本)
Alex1987 2012年

我希望我可以为此答案提供更多的声誉点……比使用CMake创建静态库要容易得多。非常感谢您这样做!
iwasrobbed

它也适用于iOS 6。但这也许是因为我的库很简单,没有任何依赖项和资源
Paulius Vindzigelskis

该解决方案存在一个大问题:其他想要使用此解决方案创建的框架的人(此解决方案建议将fremework模板安装到xcode)必须将此模板安装到THEIR xcode上!!!
evya 2014年

您只需要为实际框架安装模板。假框架可以在未修改的Xcode中正常运行。
卡尔

30

有一个命令行实用程序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脚本),但很容易理解。我配置了仅运行此脚本的新目标。该脚本是为命令行设计的,但未在:)中进行测试

核心概念是xcodebuildlipo

我在Xcode UI中尝试了许多配置,但是没有任何效果。因为这是一种批处理,所以命令行设计更合适,因此Apple逐渐从Xcode删除了批处理构建功能。因此,我不希望他们将来提供基于UI的批处理构建功能。


谢谢,基本的简单命令似乎仍然有效,这很有趣-只是Apple显着破坏了它们的GUI。看起来我可以制作一个完全自定义的项目模板,该模板不会“烂烂”并通过预先制作所有Targets并用xcode build vars连接此脚本来修复Apple的问题。我将在我的下一个项目中尝试一下:)
亚当

1
我使用了与此类似的脚本,并将其放在仅包含shell脚本的新目标下。上面的递归构建脚本非常聪明,但不必要地造成混淆。
benzado 2011年

1
我更喜欢这样的shell脚本,这是我的想法gist.github.com/3178578
slf 2012年

@benzado是的,我有意避免了复杂性,因为我认为shell脚本必须易于阅读以进行修改。
埃尼尔(Eonil)2012年

lipo:无法打开输入文件:/ Debug-iphoneos /
Dima

11

我需要一个用于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

7

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

谢谢。我今天早上做了类似的更改,但是使用了\ d。我想这就是我们想要的(比您的好还是坏?)... grep -o'\ d \ {1,2 \} \。\ d \ {2 \} $'
Adam

我觉得我的是更可靠的,因为它只考虑数字

1
不,您匹配一种特定的数字书写方式。鉴于Apple过去对(和使用)经过修饰的字符和文本(例如,在文件名中)的支持,我希望您专有的几位数字选择不太可靠。
亚当

1
好吧,也许你是对的。至少我的项目也能正常工作,我们对接下来的89个ios版本是安全的
ben

@ben解决方案对我有用,Adam的正则表达式'[\\。0-9] \ {3,4 \} $'给出错误代码2
Zee

4

我已将其制作为Xcode 4模板,与Karl的静态框架模板相同。

我发现构建静态框架(而不是普通的静态库)由于明显的链接器错误而导致LLVM随机崩溃-因此,我想静态库仍然有用!


迈克尔,您好,我已经尝试了您的静态库模板,但是我可以针对模拟器而不是针对设备进行编译,这是错误:**失败了**以下构建命令失败:ProcessPCH / var / folders / qy / ncy6fkpn6677qt876ljrc54m0000gn / C / com .apple.Xcode.501 / SharedPrecompiledHeaders / MenuBarUniversal-Prefix-gwxxzpanxyudmfgryorafazokagi / MenuBarUniversal-Prefix.pch.pth MenuBarUniversal / MenuBarUniversal-Prefix.pch常规armv7 Objective-c com.apple.compilers.llvm.clang。 )仅显示前200条通知,命令/ bin / sh失败,退出代码为65
Kappe 2012年

2

做得好!我一起破解了一些类似的东西,但是不得不单独运行它。将其作为构建过程的一部分使其变得非常简单。

一项注意事项。我注意到它不会复制您标记为公共的任何包含文件。我已经将脚本中的内容调整为适合您的脚本,并且效果很好。将以下内容粘贴到脚本的末尾。

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

1
好的,我已经将其添加到上面的答案中。(还没有机会进行测试,但是对我来说看起来是正确的)
Adam

1

我实际上只是为此目的编写了自己的脚本。它不使用Xcode。(它基于Gambit Scheme项目中的类似脚本。)

基本上,它运行./configure并执行三次(对于i386,armv7和armv7s),并将每个结果库组合成一个胖的lib。

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.