Xcode多环境配置一共有3种形式：

• Target
• Scheme
• xcconfig

Project:包含了项目所有的代码、资源文件、所有信息。（一个项目是多个project的集合）
Target:对指定代码和资源文件的具体构建方式。（指定某些代码如何生成ipa包，类似打工人的角色）
Scheme:对指定Target的环境配置。（配置编译环境变量）
这也就是我们修改一些配置的时候需要选中Target再去修改的原因。

多Target配置

在项目中选中Target复制就生成新的Target了。

image.png

image.png

image.png

#if DEV
#import "TestMutableConfig_dev-Swift.h"
#else
#import "TestMutableConfig-Swift.h"
#endif

对应的Swift文件：

image.png

image.png

#if DEV
func log(message: String) {
    print(message)
}
#endif

➜  ~  swiftc --help | grep -- '-D'
-D <value>              Marks a conditional compilation flag as true

Target方式配置多环境
1.会生成多个Info.plist文件；
2.配置比较繁琐，需要同步配置容易混乱
那么对于多Target的场景是可以在Build Phases中控制要编译的文件和资源。

image.png

多scheme配置

scheme默认有Debug和Release的config我们可以按需添加。在Target中添加变量的时候已经用到过了。
配置在Project -> Info -> Configurations中

image.png

image.png

image.png

image.png

image.png

image.png

release包赋值为0，debug包赋值为1。这样在上传ipa包的时候后端读取Info.plist做判断，debug包直接报错不让传。
这里实现以下方式1：
Targets -> Build Settings -> + -> Add User-Defined Setting：

image.png

image.png

image.png

• User-Defined添加配置；
• Info.plist暴露配置的目的。

在代码中测试下：

    NSString *infoPath = [[NSBundle mainBundle] pathForResource:@"Info" ofType:@"plist"];
    NSDictionary *infoDic = [[NSDictionary alloc] initWithContentsOfFile:infoPath];
    NSLog(@"IPAFLAG = %@",infoDic[@"IPAFLAG"]);

Debug下:

 IPAFLAG = 1

当然也可以配置app图标:
在Assets.xcassets中添加不同的资源文件

image.png

Scheme还可以控制传递参数等，一般不常用。

image.png

多Scheme情况只需要在一个build setting中就能完成配置了，比多Target方便好维护。
缺点是还需要在build setting中设置。

xcconfig

这个我们平时都接触到了，可能好多人没有注意到，用的最广泛的就是cocoapods。
比如Other Linker Flags、Search Paths。

image.png

image.png

image.png

FRAMEWORK_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}/AFNetworking"
GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1
HEADER_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}/AFNetworking/AFNetworking.framework/Headers"
LD_RUNPATH_SEARCH_PATHS = $(inherited) '@executable_path/Frameworks' '@loader_path/Frameworks'
OTHER_LDFLAGS = $(inherited) -framework "AFNetworking"
PODS_BUILD_DIR = ${BUILD_DIR}
PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)
PODS_PODFILE_DIR_PATH = ${SRCROOT}/.
PODS_ROOT = ${SRCROOT}/Pods
USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES

xcconfig是key-value的形式配置的。那么怎么对应到xcconfig文件的呢？

image.png

配置自己的xcconfig文件

新建 -> Configuration Settings File

image.png

image.png

image.png

• 1中设置是对整个Project生效。
• 2中设置是对Target生效。

还是以IPAFLAG为例，以xcconfig的方式配置。
plist中的配置不变，User-Defined配置删除

    <key>IPAFLAG</key>
    <string>${IPAFLAG}</string>

Config-TestMutableConfig.Debug.xcconfig

IPAFLAG = 1

Config-TestMutableConfig.Release.xcconfig

IPAFLAG = 0

代码中读取下：

    NSString *infoPath = [[NSBundle mainBundle] pathForResource:@"Info" ofType:@"plist"];
    NSDictionary *infoDic = [[NSDictionary alloc] initWithContentsOfFile:infoPath];
    NSLog(@"IPAFLAG = %@",infoDic[@"IPAFLAG"]);

IPAFLAG = 1

这样配置更清晰，便于管理。

xcconfig其它用途

处了配置变量还可以配置Build Setting中的配置：

IPAFLAG = 1
//ld
OTHER_LDFLAGS = -framework "AFNetworking"

image.png

image.png

image.png

IPAFLAG = 1

//ld配置连接器
//OTHER_LDFLAGS为build中的缩写
OTHER_LDFLAGS = -framework "AFNetworking"

HEADER_SEARCH_PATHS = /usr/info

image.png

所以xcconfig配合scheme以及config就完成了项目的多环境配置。并且xcconfig可以直接复制到其它项目复用。

冲突解决

前面说过cocoapods会创建xcconfig文件，在上面的例子中就和自己创建的冲突了。因为Configurations中只能指定一个。
当然Cocoapods安装的时候不会覆盖我们在Configurations配置的。

image.png

[!] CocoaPods did not set the base configuration of your project 
because your project already has a custom config set. 
In order for CocoaPods integration to work at all, please either set the base configurations of the target `TestMutableConfig` to `Target Support Files/Pods-TestMutableConfig/Pods-TestMutableConfig.debug.xcconfig` 
or include the `Target Support Files/Pods-TestMutableConfig/
Pods-TestMutableConfig.debug.xcconfig` in your build configuration 
(`TestMutableConfig/Config/Config-TestMutableConfig.Debug.xcconfig`).

在这里已经给提示让我们导入了。

#include "Target Support Files/Pods-TestMutableConfig/Pods-TestMutableConfig.debug.xcconfig"

导入后依然报错：

image.png

#include "Pods/Target Support Files/Pods-TestMutableConfig/Pods-TestMutableConfig.debug.xcconfig"
IPAFLAG = 1

//ld配置连接器
//OTHER_LDFLAGS为build中的缩写
OTHER_LDFLAGS = -framework "AFNetworking"

再次pod install就没有警告了

image.png

image.png

image.png

#include "Pods/Target Support Files/Pods-TestMutableConfig/Pods-TestMutableConfig.debug.xcconfig"
IPAFLAG = 1

//ld配置连接器
//OTHER_LDFLAGS为build中的缩写
OTHER_LDFLAGS = $(inherited) -framework "AFNetworking"

可以看到继承过来了

image.png

代码中调用下：

image.png

推荐使用scheme + xcconfig配置管理项目环境。当然在build setting中设置的并不会被覆盖(不同名，同名可以继承，如果是值key相同会覆盖后面有总结优先级)

xcconfig配置总结

key-value 组成

配置文件由一系列键值分配组成：

BUILD_SETTING_NAME = value

注释

xcconfig文件只有一种注释方式//

//

那么这里就有一个问题了，如果我们要配置一个域名该怎么办呢？比如：

HOST_URL = https://127.0.0.1

可以通过中间值解决：

TEMP=/
HOST_URL = https:${TEMP}/127.0.0.1

include导入其他设置

可以通过include关键字导入其他的xcconfig内的配置。通过include关键字后接上双引号：

#include "Other.xcconfig"

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

#include "/Users/zaizai/Desktop/TestMutableConfig/Pods/Target Support Files/Pods-TestMutableConfig/Pods-TestMutableConfig.debug.xcconfig"

相对路径，以${SRCROOT}路径为开始：

#include "Pods/Target Support Files/Pods-TestMutableConfig/Pods-TestMutableConfig.debug.xcconfig"

变量

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

1. 在xcconfig中定义的变量与Build Settings的一致，会发生覆盖。可以通过$(inherited)让当前变量继承变量原有值。（当然对于系统的key最好都加上$(inherited)`）

//A config
OTHER_LDFLAGS = -framework SDWebImage
//B config
OTHER_LDFLAGS = $(inherited) -framework AFNetworking
//build setting中
// OTHER_LDFLAGS = -framework SDWebImage -framework AFNetworking

⚠️：有部分变量不能通过xcconfig配置到Build Settings中。如：配置PRODUCT_BUNDLE_IDENTIFIER不起作用。

2. 引用变量，$()和${}两种写法都可以

VALUE=HotpotCat

KEY1=$(VALUE)
KEY2=${VALUE}

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

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

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

$(BUILD_SETTING_NAME:default=value)

优先级(高->低)

• 手动配置Target Build Settings;
• Target中配置的xcconfig文件;
• 手动配置Project Build Settings;
• Project中配置的xcconfig文件。

资料

xcodebuildsettings