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

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

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

我正在寻找一种简单,便携,可重复使用的技术,可以在Xcode中完成。

有些历史:

  • 在2008年,我们曾经能够制作包含模拟和设备的单个静态库。 苹果禁用了。
  • 在整个2009年,我们制作了一对静态库 - 一个用于sim,一个用于设备。 苹果现在也禁用了。
  • 参考文献:

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

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

  • 由于苹果最新的变化,模拟器部分与arm6 / arm7的差异不再一样 - 这是一个不同的问题,参见上文)

  • 备择方案:

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

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

    使用它,然后调整它以添加对存档构建的支持 - cf @ Frederik对他正在使用的更改进行评论,以使其与存档模式很好地配合使用。


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

  • 关于如何将这个脚本与项目嵌入到另一个项目中使用的信息(尽管我强烈建议不要那么做 - 如果你在Xcode中相互嵌入项目​​的话,苹果在Xcode中会遇到一些显示停止的bug 3.x到Xcode 4.6.x)

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

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

  • “复制标题”部分现在考虑公共标题位置的构建设置(由Frederik Wallner提供)

  • 感谢Doug Dickinson,增加了SYMROOT的显式设置(可能需要设置OBJROOT?)


  • 脚本(这是你必须复制/粘贴)

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

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

    安装说明

  • 创建一个静态lib项目
  • 选择目标
  • 在“Build Settings”选项卡中,将“仅生成活动架构”设置为“NO”(对于所有项目)
  • 在“构建阶段”选项卡中,选择“添加...新建阶段...新建运行脚本构建阶段”
  • 将脚本(上图)复制/粘贴到框中
  • ...奖金可选用法:

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

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

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

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

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


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

  • 做上面的一切,检查它的工作原理
  • 创建一个新的运行脚本阶段,在第一个之后出现(复制/粘贴下面的代码)
  • 在Xcode中创建一个新的Target,类型为“bundle”
  • 在您的MAIN PROJECT中,在“Build Phases”中,将新捆绑包添加为“依赖”(顶部,点击加号按钮,滚动到底部,在您的产品中找到“.bundle”文件)
  • 在新的丛集目标中,在“构建阶段”中,添加一个“复制束资源”部分,并将所有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}"
    

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

    要点是分别建立两个库(一个用于设备,另一个用于模拟器),重命名它们以区别对方,然后将lipo - 创建为一个库。

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

    我试了一下,它的工作原理!


    我制作了一个XCode 4项目模板,可以让您像制作常规库一样轻松制作通用框架。

    链接地址: http://www.djcxy.com/p/22695.html

    上一篇: Build fat static library (device + simulator) using Xcode and SDK 4+

    下一篇: Instantiate Spring prototype bean with arguments and injections