小编典典

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

all

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

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

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

一些历史:

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

参考:

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

    • 他的脚本中有一些错误,这意味着它只能在他的机器上运行——他应该使用 BUILT_PRODUCTS_DIR 和/或 BUILD_DIR 而不是“猜测”它们)
    • Apple 最新的 Xcode 阻止你做他所做的事情——它根本不起作用,因为 Xcode 处理目标的方式发生了(记录的)变化)
    • 另一个 SO 提问者询问如何在没有 xcode 的情况下做到这一点,并且回答集中在 arm6 与 arm7 部分 - 但忽略了 i386 部分:我如何为 armv6、armv7 和 i386 编译静态库(fat)

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


阅读 85

收藏
2022-04-27

共1个答案

小编典典

备择方案:

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

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

使用它,然后对其进行调整以添加对存档构建的支持- 参见下面@Frederik的评论,关于他用来使其与存档模式很好地配合使用的更改。

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

最近的变化: 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 提供): op​​en “${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. 在您的新捆绑目标中,在“构建阶段”中,添加“复制捆绑资源”部分,然后将所有 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}"
2022-04-27