Xcode多环境配置
Xcode多环境配置一共有3种形式:
- Target
- Scheme
- xcconfig
Project:包含了项目所有的代码、资源文件、所有信息。(一个项目是多个project的集合)
Target:对指定代码和资源文件的具体构建方式。(指定某些代码如何生成ipa
包,类似打工人的角色)
Scheme:对指定Target的环境配置。(配置编译环境变量)
这也就是我们修改一些配置的时候需要选中Target
再去修改的原因。
多Target配置
在项目中选中Target
复制就生成新的Target
了。
Info.plist
文件,在Target
中修改bundleId
后就相当于两个Target
是两个App
了。同时可以在
Preprocessor Macros
中配置一些宏定义用于代码中区分Target
。#if DEV
#import "TestMutableConfig_dev-Swift.h"
#else
#import "TestMutableConfig-Swift.h"
#endif
➜ ~ swiftc --help | grep -- '-D'
-D <value> Marks a conditional compilation flag as true
Target
方式配置多环境1.会生成多个
Info.plist
文件;2.配置比较繁琐,需要同步配置容易混乱
那么对于多
Target
的场景是可以在Build Phases
中控制要编译的文件和资源。多scheme配置
scheme
默认有Debug
和Release
的config
我们可以按需添加。在Target
中添加变量的时候已经用到过了。
配置在Project -> Info -> Configurations
中
Scheme
就可以了。Scheme
运行就可以了。ipa
的时候,有时候会错将debug
模式下的包上传上去,尤其是在发灰度包的时候。这里有两个方案:1.通过
config
配置。2.打包的时候通过脚本修改
info.plist
文件增加一个变量。release
包赋值为0
,debug
包赋值为1
。这样在上传ipa
包的时候后端读取Info.plist
做判断,debug
包直接报错不让传。
这里实现以下方式1:Targets -> Build Settings -> + -> Add User-Defined Setting
:
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
在
Assets.xcassets
中添加不同的资源文件多Scheme
情况只需要在一个build setting
中就能完成配置了,比多Target
方便好维护。
缺点是还需要在build setting
中设置。
xcconfig
就是使用xcconfig
配置的:
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
文件的呢?
在Configurations
中对应配置的。
配置自己的xcconfig
文件
新建 -> Configuration Settings File
1
中设置是对整个Project
生效。2
中设置是对Target
生效。
还是以IPAFLAG
为例,以xcconfig
的方式配置。plist
中的配置不变,User-Defined
配置删除
<key>IPAFLAG</key>
<string>${IPAFLAG}</string>
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配置总结
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命名规则,仅由大写字母,数字和下划线_
组成,原则上大写,也可以不。字符串可以是"
也可以是'
号。
- 在
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
不起作用。
- 引用变量,
$()
和${}
两种写法都可以
VALUE=HotpotCat
KEY1=$(VALUE)
KEY2=${VALUE}
- 条件变量,根据
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
文件。
作者:HotPotCat
链接:https://www.jianshu.com/p/ca0ac4ff4fc1