iOS xcconfig编写示例教程

Sabah ·

更新时间:2024-09-20

· 1519 次阅读

引言

注释

include导入其他设置

变量

优先级（由高到低）

引言

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

BUILD_SETTING_NAME = value

注释

xcconfig文件只有一种注释方式，就是//。

include导入其他设置

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

#include "Debug.xcconfig"

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

// 表示确切的文件位置
#include "/Users/ws/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，来指定变量为空时的默认值：