XCode环境变量及路径设置
一般我们在xcode里面配置包含工程目录下头文件的时候,都要关联着相对路径和绝对路径,如果只是自己用这个项目,用绝对路径的问题不大,但是如果你把工程发给别人,别人就要在改这个绝对路径,这时候绝对路径的缺点立马出现。 所以在修改User Header Search Paths这个选项的时候使用 "$(SRCROOT)/当前工程名字/需要包含头文件所在文件夹" 将上面的双引号里面的字符串拷贝之后,你会发现这个“$(SRCROOT)”,会自动变成当前工程所以的目录。 这样就可以了,发给别人,别人也不用在去修改路径了。 xcode4的环境变量,Build Settings参数,workspace及联编设置 一、xcode4中的环境变量 $(BUILT_PRODUCTS_DIR) build成功后的,最终产品路径--可以在Build Settings参数的Per-configuration Build Products Path项里设置 $(TARGET_NAME) 目标工程名称 $(SRCROOT) 工程文件(比如Nuno.xcodeproj)的路径 $(CURRENT_PROJECT_VERSION) 当前工程版本号 其他: 当编译静态库,设备选模拟器(iPhone 5.0 Simulator),未设置任何Build Settings参数时,默认的基础路径: /Users/xxx/Library/Developer/Xcode/DerivedData/xxxWorkspace-caepeadwrerdcrftijaolkkagbjf 下面用$()代替上面一长串东东 $(SYMROOT) = $()/Build/Products $(BUILD_DIR) = $()/Build/Products $(BUILD_ROOT) = $()/Build/Products 这三个变量中的$()不会随着Build Settings参数的设置而改变 相反,以下可以通过设置而改变 $(CONFIGURATION_BUILD_DIR) = $()/Build/Products/Debug-iphonesimulator $(BUILT_PRODUCTS_DIR) = $()/Build/Products/Debug-iphonesimulator $(CONFIGURATION_TEMP_DIR) = $()/Build/Intermediates/UtilLib.build/Debug-iphonesimulator $(TARGET_BUILD_DIR) = $()/Build/Products/Debug-iphonesimulator $(SDK_NAME) = iphonesimulator5.0 $(PLATFORM_NAME) = iphonesimulator $(CONFIGURATION) = Debug $(TARGET_NAME) = UtilLib $(EXECUTABLE_NAME) = libUtilLib.a 可执行文件名 ${IPHONEOS_DEPLOYMENT_TARGET} 5.0 $(ACTION) = build $(CURRENTCONFIG_SIMULATOR_DIR) 当前模拟器路径 $(CURRENTCONFIG_DEVICE_DIR) 当前设备路径 $(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME = $()/Build/Products/Debug-iphonesimulator $(PROJECT_TEMP_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) = $()/Build/Intermediates/UtilLib.build/Debug-iphonesimulator 自定义变量 ${CONFIGURATION}-iphoneos 表示:Debug-iphoneos ${CONFIGURATION}-iphonesimulator 表示:Debug-iphonesimulator $(CURRENTCONFIG_DEVICE_DIR) = ${SYMROOT}/${CONFIGURATION}-iphoneos $(CURRENTCONFIG_SIMULATOR_DIR) = ${SYMROOT}/${CONFIGURATION}-iphonesimulator 自定义一个设备无关的路径(用来存放各种架构arm6/arm7/i386输出的产品) $(CREATING_UNIVERSAL_DIR) = ${SYMROOT}/${CONFIGURATION}-universal 自定义变量代表的值 $(CURRENTCONFIG_DEVICE_DIR) = $()/Build/Products/Debug-iphoneos $(CURRENTCONFIG_SIMULATOR_DIR) = $()/Build/Products/Debug-iphonesimulator $(CREATING_UNIVERSAL_DIR) = $()/Build/Products/Debug-universal iphoneos5.0下的编译脚本: xcodebuild -project "UtilLib.xcodeproj" -configuration "Debug" -target "UtilLib" -sdk "iphoneos5.0" -arch "armv6 armv7" build RUN_CLANG_STATIC_ANALYZER=NO $(BUILD_DIR)="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" iphonesimulator5.0下的编译脚本: xcodebuild -project "UtilLib.xcodeproj" -configuration "Debug" -target "UtilLib" -sdk "iphonesimulator5.0" -arch "i386" build RUN_CLANG_STATIC_ANALYZER=NO $(BUILD_DIR)="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" 加上下面一句表示输出到文件: > "${BUILD_ROOT}.build_output" lipo脚本工具:合并iPhone模拟器和真机的静态类库,生成通用库 lipo -create -output "${CREATING_UNIVERSAL_DIR}/${EXECUTABLE_NAME}" "${CURRENTCONFIG_DEVICE_DIR}/${EXECUTABLE_NAME}" "${CURRENTCONFIG_SIMULATOR_DIR}/${EXECUTABLE_NAME}" 意思是:把"${CURRENTCONFIG_DEVICE_DIR}目录下的.a文件,和${CURRENTCONFIG_SIMULATOR_DIR}目录下的.a文件合并, 在${CREATING_UNIVERSAL_DIR}目录下,生成两个设备都通用的静态库, 例如:lipo -create -output xy.a x.a y.a 二、xcode4中build Settings常见参数解析 1.Installation Directory:安装路径 静态库编译时,在Build Settings中Installation Directory设置“$(BUILT_PRODUCTS_DIR)” Skip Install设为YES Installation Directory默认为/usr/local/lib 因为Build Location默认时,.a文件会放在很长(比如:/Users/xxx/Library/Developer/Xcode/DerivedData/xxxProgram dalrvzehhtesxdfqhxixzafvddwe/Build/Products/Debug-iPhoneos)的路径下,或是我们target指定的路径 Skip Install如果是NO,可能会被安装到默认路径/usr/local/lib 2.Public Headers Folder Path:对外公开头文件路径 设为“include”(具体的头文件路径为:$(BUILT_PRODUCTS_DIR)/include/xx.h) 在最终文件.a同级目录下生成一个include目录 默认:/usr/local/include Public Headers Folder Path这个路径就是使用这lib的某工程需要依赖的外部头文件.导入这路径后,#include/import "xx.h"才能看到 3.User Header Search Paths:依赖的外部头文件搜索路径 设置为“$(BUILT_PRODUCTS_DIR)/include” 和2中路径对应 4.Per-configuration Build Products Path:最终文件路径 比如设为“../app”,就会在工程文件.xcodeproj上一层目录下的app目录里,创建最终文件 默认为$(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) 等于$(BUILT_PRODUCTS_DIR) 5.Per-configuration Intermediate Build Files Path:临时中间文件路径 默认为:$(PROJECT_TEMP_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) 6.Code Signing Identity:真机调试的证书选择 选一个和Bundle identifier相对应的证书 Library Search Paths:库搜索路径 Architectures:架构,设为 armv6 或 armv7 Valid Architectures:应用框架,可以设为 armv6、 armv7 或i386 Product Name:工程文件名,默认为$(TARGET_NAME) Info.plist File:info文件路径 Build Variants:默认为normal Other Linker Flags:其他链接标签 设为“-ObjC” 当导入的静态库使用了类别,需要设为-ObjC iOS Deployment Target:ios部署对象 比如可以选择设为,ios3到ios5的一种版本 Prefix Header:预编头文件(比如:UtilLib/UtilLib-Prefix.pch) Precompile Prefix Header:设为“Yes”,表示允许加入预编译头 三、workspace(工作区) 作用:管理多个工程(project),多工程联编 四、workspace多工程联编设置 一、 1.新建一个静态库工程,比如UtilLib,并生成UtilLib.h和UtilLib.m文件 2.选中需要公开的头文件, 把右侧栏的Target Membership中设置为public 或则,选中工程目录target的Build Phases标签的copy headers项,在public中添加要公开的头文件 3.Architectures设为:armv6 armv7 4.Valid Architectures设为:armv6 armv7 i386 5.Build Products Path设为:$(SRCROOT)/../build 6.Per-configuration Build Products Path设为: $(SRCROOT)/../build/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) 7.Per-configuration Intermediate Build Files Path设为: $(SRCROOT)/../build/$(TARGET_NAME).build/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) 8.设置安装路径:Installation Directory项 9.设置对外公开的头文件路径:Public Headers Folder Path项 10.为静态库添加依赖的shell脚本 选中工程目录target的Build Phases标签,点击由下角的Add Build Phase按钮 在弹出的菜单里选择Add run script项,然后页面中会多出一个Run Script项 在黑框里填写"$SRCROOT/mergeArmSymbols.sh" 建立对此脚本的依赖(编译静态库的后会运行此脚本) 如果编译时设备选的是iphone simulator: 则此脚本会在对应iphone device的产品目录Debug-iphoneos中,生成对device有用的.a静态库, 相反,如果设备选的是iphone device: 则此脚本会在对应iphone simulator的产品目录Debug-iphoneos中,生成对simulator有用的.a静态库 最后,此脚本调用lipo工具,把本工程生成静态库与此脚本生成的静态库合并,生成simulator和device都通用的.a文件 11.具体bash shell脚本如下: [plain] view plaincopy mergeArmSymbols.sh # Version 2.0 (updated for Xcode 4, with some fixes) # 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) # # More info: see this Stack Overflow question: http://stackoverflow.com/questions/3520977/build-fat-static-library-device-simulator-using-xcode-and-sdk-4 #################[ Tests: helps workaround any future bugs in Xcode ]######## # DEBUG_THIS_SCRIPT="true" 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" echo "SDK_NAME = $SDK_NAME" echo "PLATFORM_NAME = $PLATFORM_NAME" echo "CONFIGURATION = $CONFIGURATION" echo "TARGET_NAME = $TARGET_NAME" echo "ARCH_TO_BUILD = $ARCH_TO_BUILD" echo "ARCH_TO_BUILD = $ARCH_TO_BUILD" echo "ACTION = $ACTION" echo "SYMROOT = $SYMROOT" echo "EXECUTABLE_NAME = $EXECUTABLE_NAME" echo "CURRENTCONFIG_SIMULATOR_DIR = $CURRENTCONFIG_SIMULATOR_DIR" echo "CURRENTCONFIG_DEVICE_DIR = $CURRENTCONFIG_DEVICE_DIR" echo "#############Other###########" echo "BUILD_DIR/CONFIGURATION/EFFECTIVE_PLATFORM_NAME = $BUILD_DIR/$CONFIGURATION$EFFECTIVE_PLATFORM_NAME" echo "PROJECT_TEMP_DIR/CONFIGURATION/EFFECTIVE_PLATFORM_NAME = $PROJECT_TEMP_DIR/$CONFIGURATION$EFFECTIVE_PLATFORM_NAME" fi #####################[ part 1 ]################## # First, work out the BASESDK version number # (incidental: searching for substrings in sh is a nightmare! Sob) SDK_VERSION=$(echo ${SDK_NAME} | grep -o '.\{3\}$') # Next, work out if we're in SIM or DEVICE if [ ${PLATFORM_NAME} = "iphonesimulator" ] then OTHER_SDK_TO_BUILD=iphoneos${SDK_VERSION} ARCH_TO_BUILD="armv6 armv7" else OTHER_SDK_TO_BUILD=iphonesimulator${SDK_VERSION} ARCH_TO_BUILD="i386" 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... build ONLY the missing platforms/configurations. if [ "true" == ${ALREADYINVOKED:-false} ] then echo "RECURSION: Not the root invocation, don't recurse" else # Prevent recursion export ALREADYINVOKED="true" echo "RECURSION: I am the root... recursing all missing build targets..." echo "RECURSION: ...about to invoke: xcodebuild -configuration \"${CONFIGURATION}\" -target \"${TARGET_NAME}\" -sdk \"${OTHER_SDK_TO_BUILD}\" -arch \"${ARCH_TO_BUILD}\" ${ACTION} RUN_CLANG_STATIC_ANALYZER=NO" xcodebuild -project "${TARGET_NAME}.xcodeproj" -configuration "${CONFIGURATION}" -target "${TARGET_NAME}" -sdk "${OTHER_SDK_TO_BUILD}" -arch "${ARCH_TO_BUILD}" ${ACTION} RUN_CLANG_STATIC_ANALYZER=NO BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" > "${BUILD_ROOT}.build_output" 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=${SRCROOT}/../build/${CONFIGURATION}-iphoneos CURRENTCONFIG_SIMULATOR_DIR=${SRCROOT}/../build/${CONFIGURATION}-iphonesimulator echo "Taking device build from: ${CURRENTCONFIG_DEVICE_DIR}" echo "Taking simulator build from: ${CURRENTCONFIG_SIMULATOR_DIR}" CREATING_UNIVERSAL_DIR=${SRCROOT}/../build/${CONFIGURATION}-universal echo "...outputing a universal arm6/arm7/i386 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}" lipo -create -output "${CREATING_UNIVERSAL_DIR}/${EXECUTABLE_NAME}" "${CURRENTCONFIG_DEVICE_DIR}/${EXECUTABLE_NAME}" "${CURRENTCONFIG_SIMULATOR_DIR}/${EXECUTABLE_NAME}" #######custom######## #copy universal lib to ../libs libsDir=../libs includeDir=../include rm -rf "${libsDir}" mkdir -p "${libsDir}" echo "cp -R ${CREATING_UNIVERSAL_DIR}/${EXECUTABLE_NAME} ${libsDir}" cp -R "${CREATING_UNIVERSAL_DIR}/${EXECUTABLE_NAME}" "${libsDir}" echo "cp -R ${CURRENTCONFIG_DEVICE_DIR}/include ${includeDir}" cp -R "${CURRENTCONFIG_DEVICE_DIR}/include" "${includeDir}" fi 下载右边的图片,然后把后缀改为.sh(其实就是上面的脚本,因为博客园只能上传图片) 静态库编译后的目录结构如下: 二、 1.新建主工程,比如Nuno,添加对静态库的依赖 点击工程,在Build Phases标签的Link Binary With Libraries项中点击加号添加UtilLib.a库 选中上面的红色项,在右边栏的Location选Relative to Project,把值设为../libs/libUtilLib.a 2.设置主工程依赖的外部头文件路径:User Header Search Paths项 $(SRCROOT)/../include 3.设置Header Search Paths为:$(SRCROOT)/../include 4.设置Library Search Paths为:$(SRCROOT)/../libs 编译运行即可实现联编 (备注:选择模拟器iphone 5.0 simulator,编译静态库的时,最终文件会在Debug-iphonesimulator,就算成功.a文件还是红色, 这是可能是xcode的bug,不会自动切换路径 因为$(BUILT_PRODUCTS_DIR)所指的位置,是build/Debug-iphonesos,不是包含最终.a文件的Debug-iphonesimulator; 选择ios Device,编译成的最终文件才在build/Debug-iphonesos下,.a文件变成非红色 所有得用mergeArmSymbols.sh脚本来解决) reference: http://blog.sina.com.cn/s/blog_6de18992010190kk.html http://www.cnblogs.com/xiaodao/archive/2012/03/28/2422091.html