Xcode多環(huán)境配置一共有3種形式：

• Target
• Scheme
• xcconfig

Project:包含了項(xiàng)目所有的代碼、資源文件、所有信息。（一個(gè)項(xiàng)目是多個(gè)project的集合）
Target:對指定代碼和資源文件的具體構(gòu)建方式。（指定某些代碼如何生成ipa包，類似打工人的角色）
Scheme:對指定Target的環(huán)境配置。（配置編譯環(huán)境變量）
這也就是我們修改一些配置的時(shí)候需要選中Target再去修改的原因。

多Target配置

在項(xiàng)目中選中Target復(fù)制就生成新的Target了。

image.png

image.png

image.png

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

對應(yīng)的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方式配置多環(huán)境
1.會生成多個(gè)Info.plist文件；
2.配置比較繁瑣，需要同步配置容易混亂
那么對于多Target的場景是可以在Build Phases中控制要編譯的文件和資源。

image.png

多scheme配置

scheme默認(rèn)有Debug和Release的config我們可以按需添加。在Target中添加變量的時(shí)候已經(jīng)用到過了。
配置在Project -> Info -> Configurations中

image.png

image.png

image.png

image.png

image.png

image.png

release包賦值為0，debug包賦值為1。這樣在上傳ipa包的時(shí)候后端讀取Info.plist做判斷，debug包直接報(bào)錯(cuò)不讓傳。
這里實(shí)現(xiàn)以下方式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

當(dāng)然也可以配置app圖標(biāo):
在Assets.xcassets中添加不同的資源文件

image.png

Scheme還可以控制傳遞參數(shù)等，一般不常用。

image.png

多Scheme情況只需要在一個(gè)build setting中就能完成配置了，比多Target方便好維護(hù)。
缺點(diǎn)是還需要在build setting中設(shè)置。

xcconfig

這個(gè)我們平時(shí)都接觸到了，可能好多人沒有注意到，用的最廣泛的就是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的形式配置的。那么怎么對應(yīng)到xcconfig文件的呢？

image.png

配置自己的xcconfig文件

新建 -> Configuration Settings File

image.png

image.png

image.png

• 1中設(shè)置是對整個(gè)Project生效。
• 2中設(shè)置是對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就完成了項(xiàng)目的多環(huán)境配置。并且xcconfig可以直接復(fù)制到其它項(xiàng)目復(fù)用。

沖突解決

前面說過cocoapods會創(chuàng)建xcconfig文件，在上面的例子中就和自己創(chuàng)建的沖突了。因?yàn)?code>Configurations中只能指定一個(gè)。
當(dāng)然Cocoapods安裝的時(shí)候不會覆蓋我們在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`).

在這里已經(jīng)給提示讓我們導(dǎo)入了。

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

導(dǎo)入后依然報(bào)錯(cuò)：

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

代碼中調(diào)用下：

image.png

推薦使用scheme + xcconfig配置管理項(xiàng)目環(huán)境。當(dāng)然在build setting中設(shè)置的并不會被覆蓋(不同名，同名可以繼承，如果是值key相同會覆蓋后面有總結(jié)優(yōu)先級)

xcconfig配置總結(jié)

key-value 組成

配置文件由一系列鍵值分配組成：

BUILD_SETTING_NAME = value

注釋

xcconfig文件只有一種注釋方式//

//

那么這里就有一個(gè)問題了，如果我們要配置一個(gè)域名該怎么辦呢？比如：

HOST_URL = https://127.0.0.1

可以通過中間值解決：

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

include導(dǎo)入其他設(shè)置

可以通過include關(guān)鍵字導(dǎo)入其他的xcconfig內(nèi)的配置。通過include關(guān)鍵字后接上雙引號：

#include "Other.xcconfig"

在引入的文件時(shí)，如果是以/開頭，代表絕對路徑:

#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命名規(guī)則，僅由大寫字母，數(shù)字和下劃線_組成，原則上大寫，也可以不。字符串可以是"也可以是'號。

1. 在xcconfig中定義的變量與Build Settings的一致，會發(fā)生覆蓋。可以通過$(inherited)讓當(dāng)前變量繼承變量原有值。（當(dāng)然對于系統(tǒng)的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. 條件變量，根據(jù)SDK、Arch和Configration對設(shè)置進(jìn)行條件化：

// 指定`Configration`是`Debug`
// 指定`SDK`是模擬器，還有iphoneos*、macosx*等
// 指定生效架構(gòu)為`x86_64`
OTHER_LDFLAGS[config=Debug][sdk=iphonesimulator*][arch=x86_64]= $(inherited) -framework "HotpotCat"

??：在Xcode 11.4及以后版本，可以使用default來指定變量為空時(shí)的默認(rèn)值。

$(BUILD_SETTING_NAME:default=value)

優(yōu)先級(高->低)

• 手動(dòng)配置Target Build Settings;
• Target中配置的xcconfig文件;
• 手動(dòng)配置Project Build Settings;
• Project中配置的xcconfig文件。

資料

xcodebuildsettings