xcconfig
文件的语法比较简单,每个配置文件都由一系列键值分配组成,这些键值分配具有以下语法:
BUILD_SETTING_NAME = value
一、注释
xcconfig
文件只有一种注释方式\\
。
include导入其他xcconfig文件设置
在创建xcconfig
文件的时候,可以根据需求,创建多个。也就意味着,可以通过include
关键字导入其他的xcconfig
内的配置。通过include
关键字后接上双引号:
#include "Debug. xcconfig"
在搜索引入的文件时,如果是以/
开头,代表绝对路径,例如:
// 表示确切的文件位置
#include "/Users/ztkj/Desktop/TestCode/Pods/Target Support Files/Pods-TestCode/Pods-TestCode.debug.xcconfig"
或者通过相对路径,以${SRCR00T}
路径为开始:
#include "Pods/Target Support Files/Pods-TestCode/Pods-TestCode.debug.xcconfig"
二、变量
变量定义,按照OC
命名规则,仅由大写字母、数字和下划线(_
)组合,原则上大写,也可以不。字符串可以是"
也可以是‘
号。
变量有三种特殊情况:
- 在
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
不起作用。
xcconfig
文件中对应Build Settings
中字段的缩写对应关系参考: Xcode Build Settings
- 引用变量,
$()
和${}
两种写法都可以:
VALUE=DIFFER
NAME=$(VALUE)-${VALUE}
- 条件变量,根据
SDK
、Arch
和Configration
对设置进行条件化,例如:
//指定Configration'是、Debug'
//指定SDK是模拟器,还有iphoneos*、 macosx*等
//指定生效架构为、x86_ 64
OTHER_LDFLAGS[config=Debug][sdk=iphonesimulator*][arch=x86_64]= $(inherited) -framework "differ"
注意⚠️: 在
Xcode 11.4
及以后版本,可以使用default
,来指定变量为空时的默认值:
$(BUILD_SETTING_NAME:default=value)
三、优先级(由高到低):
- 手动配置
Target Build Settings
-
Target
中配置的xcconfig
文件 - 手动配置
Project Build Settings
-
Project
中配置的xcconfig
文件