Xcode 多条件编译xcconfig文件配置指南

什么是xcconfig文件

简单来说，xcconfig是苹果在xcode文件中用来使同一套代码能够在不同的条件下编译，运行的一个配置文件

怎么生成和配置一个配置文件

• 1.在工程中添加一个新文件，如图所示，选中配置文件模板，并且命名

  
  
  image

• 2.在工程配置中配置刚刚添加的文件，你可以配置1-n个环境的xcconfig文件
  

  

  image

• 3.现在你可以愉快的使用各种配置开发了

xcconfig文件语法介绍

• xcconfig的语法比较简单，就是简单的键值配对语法，如下

BUILD_SETTING_NAME = value

• 注释
  xcconfig的只支持一种注释 \\

• 使用#include导入其他设置

  • xcconfig文件可以创建多个，可以在xcconfig中根据需求，将其他xcconfig的配置导入到本文件，通过#include关键字+上对应的xcconfig文件路径就可以

  1.支持绝对路径添加

  #include "/Users/someone/testxcConfig/testxcConfig/testxcConfig.Debug.xcconfig"
  

  2.支持相对路径，实际上就是${SRCROOT}路径链接后面的文件路径

   #include "testxcConfig/testxcConfig.Debug.xcconfig"
  

变量

变量定义，按照OC命名，仅又大写字母，数字和下划线构成，原则上大写，但也可以小写；字符串可以是",也可以';变量有三种特殊情况：

1.在xcconfig定义的变量与Build Setting中的变量相同，那么就会发生覆盖的情况，可以通过$(inherited)关键字继承Build Setting的值，例如:

 OTHER_LDFLAGS = -framework SDWebImage
 OTHER_LDFLAGS = $(inherited) -framework AFNetworking
最后的结果就是 // OTHER_LDFLAGS = -framework SDWebImage -framework AFNetworking

注意：有部分变量不能通过xcconfig 配置到Build Settings，比如 配置 PRODUCT_BUNDLE_IDENTIFIER不会起作用

2.引用变量 ${}和￥()都可以

VALUE=OC
LANAUAGE=$(VALUE)-${VALUE}

条件变量，根据SDK,Arch和Configration 对设置进行条件化

//指定`Configration`是`Debug`
 //指定`SDK`是模拟器,还是`iphoneos*或者`macosx*`
 //指定生效架构是`x86_64`
OTHER_LDFLAGS[config=Debug][sdk=iphonesimulator*[arch=x86_64]= $(inherited) -framework "Demo"

注意： 在Xcode 11.4 及之后版本，可以知道default,来指定变量为空时的默认值

$(BUILD_SETTING_NAME:default=value)

优先级从高到低

1.手动配置Target Build Settings

2.Target中配置的xcconfig文件

3.手动配置roject Build Settings

4.Project中配置的xcconfig文件