xcconfig指南

xcconfig

xcconfig指南

• xcconfig文件的语法比较简单，每个配置文件都由一系列键值对分配组成，这些键值分配具有以下语法：

BUILD_SETTING_NAME = value

注释

• xcconfig文件只有一种注释方式\\.

include导入其他设置

• 在创建xcconfig文件的时候，可以根据需求，创建多个。也就意味着，可以通过include关键字导入其他xcconfig内的配置。通过include关键字接上双引号：

#include "Debug.xcconfig"

• 在搜索引入的文件时，如果以/开头，代表绝对路径，例如：

// 表示确切的文件位置
#include "Users/.../Pods/.../Pods-LoginApp.debug.xcconfig"

• 或者通过相对路径，以${SRCROOT}路径为开始

#include "/Pods/.../Pods-LoginApp.debug.xcconfig"

变量

• 变量定义，按照OC命名规则，仅由大写字母，数字和下划(_)组成，原则上大写，也可以不。字符串可以是"也可以是'号

1. 在xcconfig中定义的变量与Build Settings的一致，那么会发生覆盖。可以通过$(inherited),让当前变量继承原有值。例如：

OTHER_LDFLAGS = -framework SDWebImage
OTHER_LDFLAGS = $(inherited) -framework AFNetworking
// OTHER_LDFLAGS = -framework SDWebImage -framework AFNetworking

*注意⚠️：有部分变量不能通过xcconfig配置到Build Settings中，例如：配置PRODUCT_BUNDLE_IDENTIFIER不起作用 2. 引用变量，$()和${}两种写法都可以：

Value=Cat
TEACHER=$(VALUE)-${VALUE}

3. 条件变量，根据SDK、Arch和Configration对设置进行条件化，例如：

// 指定`Configration`是`Debug`
// 指定`SDK`是模拟器，还有iphoneos*、macosx*等
// 指定生效架构为`x86_64`
OTHER_LDFLAGS[config=Debug][sdk=iphonesimulator*[arch=x86_64]= $(inherited) -framework "Cat"

注意⚠️：在Xcode 11.4及以后版本，可以使用defailt，来指定变量为空时的默认值：

$(BUILD_SETTING_NAME:default=value)

优先（由高到低）：

1. 手动配置Target Build Settings
2. Target中配置的xcconfig文件
3. 手动配置Project Build Settings
4. Project中配置的xcconfig文件