注册

Xcode多环境配置

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

  • Target
  • Scheme
  • xcconfig

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

多Target配置

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

ecd8c1743de8327a759526054048b195.pnge3ebcbdfbe5863e3a04d362b0ed436cc.png


相当于可以直接分别配置Info.plist文件,在Target中修改bundleId后就相当于两个Target是两个App了。
同时可以在Preprocessor Macros中配置一些宏定义用于代码中区分Target

0366579ab6d114dca982241aa29a0a10.png

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

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


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

cb0853f8f4ab87e390b5b4dffc7e3353.png

多scheme配置

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

dbe114b25630192ed713bfed1a433281.png


运行/打包的时候选择对应的Scheme就可以了。

e91e032fa5ac9f5e1b5d30e91b7c81e2.png997f4d249494fafba4a43a5c9c2df228.png3d089db66940bebab0a789e3e7c7bd35.png

这个时候只需要切换Scheme运行就可以了。

比如我们上传打包ipa的时候,有时候会错将debug模式下的包上传上去,尤其是在发灰度包的时候。这里有两个方案:
1.通过config配置。
2.打包的时候通过脚本修改info.plist文件增加一个变量。

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


b6a89fc8ccb17cc27cfaf5d429145815.png6b0deb5389a8e61b51ac14fbca4e28cd.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中添加不同的资源文件

b9d9b253e79afa471b04ce929fe0d526.png

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

xcconfig

ed75ffdff1aa75248fb9e6d3d3db423b.png

就是使用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

xcconfigkey-value的形式配置的。那么怎么对应到xcconfig文件的呢?

ce6d610aa465ee6a19b7a9beee9f226f.png
Configurations中对应配置的。

配置自己的xcconfig文件

新建 -> Configuration Settings File


4d648cbe140dc8b76b2b59d7a46b8f4a.png40a39d2120c3ebe2fd6c25c8286f908c.png5691a24cb1d2d77c3f85d31d8862053b.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配置总结

key-value 组成

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

BUILD_SETTING_NAME = value

注释

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

//

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

可以通过中间值解决:

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不起作用。

  1. 引用变量,$()${}两种写法都可以
VALUE=HotpotCat

KEY1=$(VALUE)
KEY2=${VALUE}
  1. 条件变量,根据SDKArchConfigration对设置进行条件化:
// 指定`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

0 个评论

要回复文章请先登录注册