xcode的环境变量，Build Settings参数，workspace及联编设置

怼烎@ 2022-06-05 04:51 615阅读 0赞

一、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.选中需要公开的头文件，

![2012032821514514.png][]

把右侧栏的Target Membership中设置为public

![2012032821520658.png][]

或则，选中工程目录target的Build Phases标签的copy headers项，在public中添加要公开的头文件

![2012032822023943.png][]

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项

![2012032822444226.png][]

9.设置对外公开的头文件路径：Public Headers Folder Path项

![2012032823052996.png][]

10.为静态库添加依赖的shell脚本

选中工程目录target的Build Phases标签，点击由下角的Add Build Phase按钮

![2012033001445848.png][]

在弹出的菜单里选择Add run script项，然后页面中会多出一个Run Script项

![2012033001465346.png][]

在黑框里填写"$SRCROOT/mergeArmSymbols.sh"

![2012033001492012.png][]

建立对此脚本的依赖（编译静态库的后会运行此脚本）

如果编译时设备选的是iphone simulator：

则此脚本会在对应iphone device的产品目录Debug-iphoneos中，生成对device有用的.a静态库，

相反，如果设备选的是iphone device：

则此脚本会在对应iphone simulator的产品目录Debug-iphoneos中，生成对simulator有用的.a静态库

最后，此脚本调用lipo工具，把本工程生成静态库与此脚本生成的静态库合并，生成simulator和device都通用的.a文件

11.具体bash shell脚本如下：

![ContractedBlock.gif][] mergeArmSymbols.sh

下载右边的图片![2012040300261146.jpg][]，然后把后缀改为.sh（其实就是上面的脚本，因为博客园只能上传图片)

静态库编译后的目录结构如下：

![2012040300174762.png][]

![2012040300180494.png][]

二、

1.新建主工程，比如Nuno，添加对静态库的依赖

点击工程，在Build Phases标签的Link Binary With Libraries项中点击加号添加UtilLib.a库

![2012032823190886.png][]

![2012032823194638.png][]

![2012032823200838.png][]

选中上面的红色项，在右边栏的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脚本来解决）

http://www.cnblogs.com/xiaodao/archive/2012/03/28/2422091.html

==============================================================================

## 1.Framework/Library Search Paths表示framework和Library引用的路径，改路径是你工程下的绝对路径 ##

2.一般用宏：$(SRCROOT)表示你的XXX.xcodeproj文件的目录，而你引用的framework和 Library相对xxxx.xcodeproj文件的目录就可以直接添加在$(SRCROOT)/后面了。

例如$(SRCROOT)/Find/who.framework表示who.framework文件是在你的工程xxxx.codeproj下的一个Find文件夹下。

3.$(EFFECTIVE\_PLATFORM\_NAME) 宏代表当前配置是OS还是simulator

4.一般情况下是不用特意去设置这些Search Paths的万一路径错了，就将你的framework和Library文件重新引用一遍就可以了，xcode会自动设置这些路径的。

//以下的“=”表示右边的表达式就是左边表达式的值！

5.$(BUILD\_DIR) = /Users/xxx/Library/Developer/Xcode/DerivedData/xxxWorkspace-caepeadwrerdcrftijaolkkagbjf/Build/Products表示程序编译后的路径，一般是表示在Xcode的DerivedData文件夹下编译后你的工程为xxxWorkspace-caepeadwrerdcrftijaolkkagbjf

说明：$(BUILD\_DIR)是不能通过build Setting改变的，而下面的都是可以通过build Setting来改变他们的值的，以下都是默认情况下，主要是为了说明宏的意思

6.$(SDK\_NAME)=iphonesimulator5.0表示获取当前SDK的名字

7.$(PLATFORM\_NAME) = iphonesimulator表示获取当前程序运行的平台

8.$(TARGET\_NAME) = UtilLib表示工程文件名UtiLib

9.$(EXECUTABLE\_NAME) = libUtilLib.a 表示可执行文件libUtiLib.a

10.$(ACTION) = build表示当前操作是编译操作

11.$(CURRENTCONFIG\_SIMULATOR\_DIR) 表示当前模拟器路径

12.$(CURRENTCONFIG\_DEVICE\_DIR) 表示当前设备路径

13.$\{CONFIGURATION\}表示当前状态是调试Debug还是运行状态release

14.$\{CONFIGURATION\}-iphoneos 表示：Debug-iphoneos(如果当前模式是Debug)

15. $(BUILD\_DIR)/$(CONFIGURATION)$(EFFECTIVE\_PLATFORM\_NAME =/Users/xxx/Library/Developer/Xcode/DerivedData/xxxWorkspace-caepeadwrerdcrftijaolkkagbjf /Build/Products/Debug-iphonesimulator表示在模拟器的调试状态下

16.当然也可以自己定义路径比如当前设备路径$(CURRENTCONFIG\_DEVICE\_DIR) = $\{SYMROOT\}/$\{CONFIGURATION\}-iphoneos其中

$\{SYMROOT\}表示：/Users/xxx/Library/Developer/Xcode/DerivedData/xxxWorkspace-caepeadwrerdcrftijaolkkagbjf/build/products目录

17.$(CREATING\_UNIVERSAL\_DIR) = /Users/xxx/Library/Developer/Xcode/DerivedData/xxxWorkspace-caepeadwrerdcrftijaolkkagbjf/Build/Products/Debug-universal

18.$(BUILT\_PRODUCTS\_DIR) = /Users/xxx/Library/Developer/Xcode/DerivedData/xxxWorkspace-caepeadwrerdcrftijaolkkagbjf/Build/Products/Debug-iphonesimulator表示程序编译后的目录

如果要在终端编译一个项目的话也可以如下：

xodebuild命令表示用xode编译，-project后面是你的工程文件，-configuration后面是以何种方式编译你的程序，-sdk 表示你运行的是真机还是模拟器

\-arch表示你设置的项目支持的处理器，RUN\_CLANG\_STATIC\_ANALYZER=NO表示是否运行静态分析器

lipo工具表示合并真机和模拟器，例如：

表示将真机目录下的可执行文件.a文件和模拟器下的可执行文件.a文件合并在目录$\{CREATING\_UNIVERSAL\_DIR\}下并生成一个可执行文件.a文件

build Settings常见参数解析：

1.Installation Directory：安装路径

静态库编译时，Build Settings中Installation Directory设置为“$(BUILT\_PRODUCTS\_DIR)”

Skip Install设为YES，因为Installation Directory默认为/usr/local/lib，Skip Install如果是NO,可能会被安装到默认路径/usr/local/lib

2.Public Headers Folder Path：对外公开头文件路径

如果设为“include”（具体的头文件路径为：$(BUILT\_PRODUCTS\_DIR)/include/xx.h）

在最终文件.a同级目录下生成一个include目录