Xcode 配置多种 Configuration

发表于 |

本文示例工程地址

Xcode 默认配置两种标准的 configuration: Debug 和 Release
，可以在 Project -> Info -> Configurations section 页面找到。Rlease 做了编译优化，不能断点调试，但是运行速度较 Debug 包更快，且体积更小。

一般情况下不需要配置额外的 configuration， 但若想 QA 同学同时装线上包和 Debug 包，或者需要区分各种测试／灰度／正式环境，那配置多种 configuration 是非常必要且方便。

配置 Configurations

在 Project -> Info -> Configurations section，直接复用 Debug 创建 DailyBuild。也可以复用 Release 创建 Store 包。
build configurations

配置 Preprocessor macros

在 Target -> BuildingSetting 中搜索 Preprocessor macros, 可以在不同的 configuration 中定义宏，如 DEBUG = 1.
preprocessor macros

在代码中即可获取预定义的宏。

1
2
3
4
5
#if DEBUG
 	print("debug or dailybuild")
#else
	print("release")
#endif

配置 Display name

在 Target -> Info 中添加 

1
2
<key>CFBundleDisplayName</key>
<string>$(APP_DISPLAY_NAME)</string>

然后在 Target -> Info 中定义 APP_DISPLAY_NAME，分别指定每个 configuration 对应的名字即可。
Display name

配置 App icon

在 Target -> Build Settings 里搜索 Asset Catalog App Icon Set Name, 配置对应的 asset 名称即可。
AppIconSetting
AppIconAsset

配置环境变量

配置

在 Target -> Info 中定义 Configuration，运行时获取 configuration。
dynamic configuration

然后可以创建 Configuration.swift, 定义如下。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
enum Environment: String {
    case DailyBuild = "DailyBuild"
    case Debug = "Debug"
    case Release = "Release"
    var baseURL: String {
        switch self {
        case .Debug: return "debug:https://v.qq.com"
        case .DailyBuild: return "db:https://v.qq.com"
        case .Release: return "release:https://v.qq.com"
        }
    }
    var token: String {
        switch self {
        case .Debug: return "debug:FEWJPFJ23T4NO4390NO"
        case .DailyBuild: return "db:FWEJPOUPGE238038R023"
        case .Release: return "release:R2UR03U2FIFFJEOUNNGW"
        }
    }
}
struct Configuration {
    lazy var environment: Environment = {
        if let configuration = Bundle.main.object(forInfoDictionaryKey: "Configuration") as? String {
            switch configuration {
            case Environment.DailyBuild.rawValue: return Environment.DailyBuild
            case Environment.Debug.rawValue: return Environment.Debug
            default: return Environment.Release
            }
        }
        return Environment.Release
    }()
}

测试

在 ViewController 的 viewDidLoad 中添加如下代码，更新 scheme 为 dailybuild 或 debug 等，console 会打印对应的 baseURL 和 token。

1
2
3
4
5
// Initialize Configuration
var configuration = Configuration()
print("baseURL: \(configuration.environment.baseURL)")
print("token: \(configuration.environment.token)")

参考