xcconfig
指南
xcconfig
文件的语法比较简单,每个配置文件都由一系列键值分配组成,这些键值分配具有以下语法:
BUILD_SETTING_NAME = value
注释
xcconfig
文件只有一种注释方式\\
。
include
导入其他设置
在创建xcconfig
文件的时候,可以根据需求,创建多个。也就意味着,可以通过include
关键字导入其他的xcconfig
内的配置。通过include
关键字后接上双引号:
include "Debug.xcconfig"
在搜索引入的文件时,如果是以\
开头,代表绝对路径,例如:
// 表示确切的文件位置
#include "/Users/xiaokang/Desktop/第一节、符号与链接/强化班第一节课资料/完成代码/LoginApp-冲突/Pods/Target Support Files/Pods-LoginApp/Pods-LoginApp.debug.xcconfig"
或者通过相对路径,以${SRCROOT}
路径为开始:
#include "Pods/Target Support Files/Pods-LoginApp/Pods-LoginApp.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
不起作用。
- 引用变量,
$()
和${}
两种写法都可以:
VALUE=Cat TEACHER=$(VALUE)-${VALUE}
- 条件变量,根据
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
及以后版本,可以使用default
,来指定变量为空时的默认值:
$(BUILD_SETTING_NAME:default=value)
优先级(由高到低):
手动配置
Target Build Settings
Target
中配置的xcconfig
文件手动配置
Project Build Settings
Project
中配置的xcconfig
文件
Xcode 中的Build Settings设置对应的xcconfig变量:Xcode Build Settings