【问题标题】:Build fat static library (device + simulator) using Xcode and SDK 4+使用 Xcode 和 SDK 4+ 构建胖静态库(设备 + 模拟器)
【发布时间】:2023-04-08 11:21:01
【问题描述】:

看来我们可以——理论上——构建一个包含模拟器和 iPhone 和 iPad 的静态库。

但是,Apple 没有我能找到的这方面的文档,而且 Xcode 的默认模板未配置为执行此操作。

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

一些历史:

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

参考资料:

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

    • 他的脚本中存在一些错误,这意味着它只能在他的机器上运行 - 他应该使用 BUILT_PRODUCTS_DIR 和/或 BUILD_DIR 而不是“猜测”它们)
    • Apple 最新的 Xcode 阻止您执行他所做的事情 - 由于 Xcode 处理目标的方式发生了(已记录的)更改,因此根本无法正常工作)
  2. 另一个 SO 提问者询问如何在没有 xcode 的情况下做到这一点,并且回答集中在 arm6 与 arm7 部分 - 但忽略了 i386 部分:How do i compile a static library (fat) for armv6, armv7 and i386

    • 由于 Apple 的最新更改,Simulator 部分不再与 arm6/arm7 的差异相同 - 这是一个不同的问题,见上文)

【问题讨论】:

  • @Cawas - 库的“重量”在 95% 的实际情况下是无关紧要的 - 对于我们大多数人来说,库很小,尤其是与例如甚至只显示一个 UIImageView。
  • @Cawas - 同时,这里的价值在于你可以让其他人更容易使用/重用你的库。它变成了一个单阶段的拖放过程。
  • @Cawas - 最后,一个令人惊讶的有价值的好处:不小心将“错误”的编译库发送给某人非常容易 - XCode 进行零检查,并且会愉快地编译将“错误”架构放入您认为是“正确”架构的命名文件中。 Apple 在这方面不断破坏 Xcode - 每个新版本都有更改,这意味着“您昨天按下以正确编译您的 lib 的按钮今天会错误地编译它”。直到 Apple 不再把我们搞得一团糟,我们需要证明他们糟糕的 UI 是白痴:)。
  • Adam,所以本质上关键是在模拟器和 iPhone 上保持相同的行为?
  • 那真的很棒!因为就目前而言,我们不能依赖模拟器来完成任何更复杂的事情。

标签: iphone xcode


【解决方案1】:

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

【讨论】:

  • 谢谢,很有趣的是底层的simple 命令似乎仍然有效——只是Apple 严重破坏了他们的GUI。看起来我可以制作一个完全自定义的项目模板,通过预先制作所有目标,并使用 xcode 构建变量连接这个脚本,“不吸”并修复 Apple 破坏的东西。我会在我的下一个项目中尝试一下:)
  • 我使用了一个类似的脚本,并将它放在一个只包含 shell 脚本的新目标下。上面的递归构建脚本非常聪明,但不必要的混乱。
  • 我更喜欢这样的 shell 脚本,这是我的看法 gist.github.com/3178578
  • @benzado 是的,我有意避免复杂性,因为我认为 shell 脚本必须易于阅读以进行修改。
  • lipo:无法打开输入文件:/Debug-iphoneos/
【解决方案2】:

替代方案:

Easy copy/paste of latest version(但安装说明可能会改变 - 见下文!)

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

Use this, then tweak it to add support for Archive builds - c.f. @Frederik 下面的评论是关于他用来使存档模式很好地工作的更改。


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

  1. 有关如何将此脚本与项目嵌入在另一个项目中的信息(尽管我强烈建议不要这样做,永远 - 如果您嵌入项目,Apple 在 Xcode 中有几个显示停止器错误从 Xcode 3.x 到 Xcode 4.6.x)

  2. 让您自动包含捆绑包的奖励脚本(即从您的库中包含 PNG 文件、PLIST 文件等!) - 见下文(滚动到底部)

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

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

  5. 添加了 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

安装说明

  1. 创建静态库项目
  2. 选择目标
  3. 在“构建设置”选项卡中,将“仅构建活动架构”设置为“否”(对于所有项)
  4. 在“Build Phases”选项卡中,选择“Add ... New Build Phase ... New Run Script Build Phase”
  5. 将上面的脚本复制/粘贴到框中

...额外的可选用法:

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

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

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

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

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

    1. 构建项目
    2. 单击右侧最后一个图标,在 Xcode4 的左上方区域。
    3. 选择最上面的项目(这是您的“最新版本”。Apple 应该自动选择它,但他们没有想到这一点)
    4. 在主窗口中,滚动到底部。最后一行应该是: lipo: for current configuration (Debug) Creating output file: /Users/blah/Library/Developer/Xcode/DerivedData/AppName-ashwnbutvodmoleijzlncudsekyf/Build/Products/Debug-universal/libTargetName.a

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


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

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

【讨论】:

  • 我现在在几个项目中使用了它,并将东西运送到使用它来构建库的应用商店。一切都 100% OK,所以我现在坚持这个(也许直到 Xcode 4)
  • 谁能确认此方法是否适用于 XCode 4.5?我正在尝试编译一个静态库并在我的主项目中使用它。我可以在设备上运行它,但不能在模拟器上运行。这是我得到的错误:在文件 /Users/alex/Documents/iphone/production/iphone/mymedia/libMyUnrar4iOS.a (2 slices) 中缺少所需的架构 i386
  • 知道如何使用 XCode 5 和 ARM64 进行这项工作吗?如果我将体系结构保留为标准,它将按预期使用 armv7、armvs7 和 i386 生成库。如果我将架构设置为包括 64 位在内的标准,则该库仅包含“cputype 16777223”。我在 .a 文件上使用 otool -h 来验证里面的内容
  • XCode5 使添加运行脚本构建阶段变得更加棘手。看看这个:runscriptbuildphase.com
  • 这似乎在 Xcode 6 上运行良好,没有任何更改(到目前为止只尝试了几个项目,还没有提交任何 App Store 更新,但到目前为止一切正常)。
【解决方案3】:

干得好!我将类似的东西拼凑在一起,但必须单独运行。将其作为构建过程的一部分使其变得简单得多。

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

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

【讨论】:

  • 好的,我已将其添加到上面的答案中。 (还没有机会测试它,但对我来说看起来是正确的)
【解决方案4】:

我制作了一个XCode 4 project template,它可以让您像制作常规库一样轻松地制作通用框架。

【讨论】:

  • 无法使用 iOS 4.3 目标构建它。收到以下错误:-stdlib=libc++ 的部署目标无效(需要 iOS 5.0 或更高版本)
  • 我希望我能给这个答案更多的声誉点......比使用 CMake 创建静态库要容易得多。非常感谢您这样做!
  • 它也适用于我的 iOS 6。但也许是因为我的 lib 非常简单,没有任何依赖和资源
  • 该解决方案存在一个大问题:其他想要使用此解决方案创建的框架的人(此解决方案建议将 fremework 模板安装到 xcode)必须将此模板安装到他们的 xcode 中!!!跨度>
  • 真实框架只需要安装模板即可。假框架可以在未经修改的 Xcode 中正常运行。
【解决方案5】:

我已经把它变成了Xcode 4 template,与 Karl 的静态框架模板相同。

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

【讨论】:

  • 嗨迈克尔,我已经尝试过你的静态库模板,但我可以为模拟器编译但不能为设备编译,这里错误:** BUILD FAILED ** 以下构建命令失败:ProcessPCH /var/folders /qy/ncy6fkpn6677qt876ljrc54m0000gn/C/com.apple.Xcode.501/SharedPrecompiledHeaders/MenuBarUniversal-Prefix-gwxxzpanxyudmfgryorafazokagi/MenuBarUniversal-Prefix.pch.pth MenuBarUniversal/MenuBarUniversal-Prefix.pch normal armv7 objective-c com.apple.compile clang.1_0.compiler (1 failure) 仅显示前 200 个通知 命令 /bin/sh 失败,退出代码为 65
【解决方案6】:

我花了很多时间尝试构建一个可以在 armv7、armv7s 和模拟器上运行的胖静态库。最后found a solution

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

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

我试过了,效果很好!

【讨论】:

  • 我建议您阅读接受的答案。你可能会发现这已经被覆盖了,2 年前......
  • 我阅读了它,使用了脚本,但它不适用于 armv7s。
  • lipo 命令在脚本上不起作用,但手动运行效果很好! 10x
  • +1 这确实是我所需要的,而不是一个巨大的“制作框架”脚本。
【解决方案7】:

我实际上只是为此目的wrote my own script。它不使用 Xcode。 (它基于 Gambit Scheme 项目中的一个类似脚本。)

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

【讨论】:

    【解决方案8】:

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

    【讨论】:

      【解决方案9】:

      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\}$'
      • 我认为我的更可靠,因为它只考虑数字
      • 不,您的匹配 1 种特殊的数字书写方式。鉴于 Apple 对(和使用)美化字符和文本(例如在文件名中)的历史支持,我预计您对几位数字的专有选择不太可靠。
      • 好吧,也许你是对的。至少我的项目也能正常运行,我们可以安全地使用接下来的 89 个 ios 版本
      • @ben 解决方案对我有用,Adam 的正则表达式 '[\\.0-9]\{3,4\}$' 给出错误代码 2
      【解决方案10】:

      XCode 12 更新:

      如果您在没有-arch 参数的情况下运行xcodebuild,XCode 12 将使用架构“arm64 x86_64”作为默认构建模拟器库。

      然后运行xcrun -sdk iphoneos lipo -create -output会冲突,因为arm64架构存在于模拟器和设备库中。

      fork script from Adam git 并修复它。

      【讨论】:

      猜你喜欢
      • 1970-01-01
      • 1970-01-01
      • 2013-01-26
      • 1970-01-01
      • 1970-01-01
      • 2023-04-01
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多