阅读 171

Xcode多环境配置

"I walk slowly, but I never walk backward."
我走得很慢,但从不后退

主要内容:

  1. 区分ProjectTargetScheme
  2. Target 配置
  3. Scheme配置
  4. xcconfig文件配置

一、区分Project、Target、Scheme

  • Project:是一个项目的整体,相当于一个仓库,包括了所有的代码和资源文件;
  • Target:相当于一个具体的产品,包含了对于代码,资源文件的具体使用规则和配置;
  • Scheme: 对指定Target的环境进行配置;

总结:一个Project可以包含多个Target,也就是说通过不同Target我们可以生成不同的APP

多环境配置的三种方法:

  1. target配置;
  2. Scheme配置;
  3. xcconfig文件配置;

二、多Target 配置

1.总结特点
  • 优点:方便管理代码,资源文件,比如在Compile SourcesCopy Bundle Resources里根据需要增加或者删除需要编译的代码和资源;
  • 缺点:配置繁琐,涉及多个info.plist文件、宏定义等,大量的修改人容易错乱;
2.基本步骤

1.创建新target

选中已有target,右键选择Duplicate,会拷贝创建出与原Target相同配置的新Target

2.修改新target的配置

由于拷贝得到的target仍使用旧的配置,为了使用新target,所以我们还需要一些额外设置:

  1. 修改新Target名字;
  2. 修改新info.plist名字;
  3. 修改Build Settings -> Packaging -> info.plist FileProduct Bundle identifier

3.修改Scheme名字

进入Scheme Manager,修改Scheme的名字,这里并非必须,修改是为了更加方便识别;

4.为了区别不同的Target,增加预定义宏

配置OC工程:Build Settings -> Preprocessor Macros

配置Swift工程:Build Settings -> Other Swift Flags

理解-D用法:

  1. swiftc编译器中,需要添加一个-Doption,代表将条件编译标志标记为true
  2. 至于-D的说明,也可以使用控制台命令查看:swiftc --help |grep '-D'
 -D <value>  Marks a conditional compilation flag as true
复制代码

5.测试target多环境

#if DEV
    print("Project DEV")
#else
    print("Project Normal")
#endif
复制代码

三、Scheme配置

配置Scheme实现多环境,其实是通过设置多种configurations的方式,具体步骤如下:

1.增加新configration

进入Project -> Info -> Configurations,在这里可以看到已经存在的DebugRelease等配置。点击“+”,可以在这里增加新的configuration(以Dev为例);

2.切换多环境

增加configuration后,在Edit Scheme时,也会多出一种configration。我们在run的时候,就可以手动切换configration使用不同的环境;

3.多Scheme

每次手动切换configration较为繁琐,我们还可以使用不同的Scheme直接对应不同的配置;

4.测试Scheme多环境

1.Build Setting -> User-Defined里自定义Host_URL,再对不同的configration配置不同的值;

2.将Host_URL以变量的方式配置到info.plist文件中;

3.读取info.plist,手动切换configration或者使用不同的Scheme运行,将得到不同的信息;

guard let path = Bundle.main.path(forResource: "Info", ofType: "plist") else { return}
guard let infoDic = NSDictionary(contentsOfFile: path) else {return}
if let host_url = infoDic["HOST_URL"] {
    print("HOST_URL:\(host_url)")
}
复制代码

四、xcconfig配置文件

xcconfig配置文件:

  1. .xcconfig配置文件,可以帮助我们以文件的形式配置build settings里的内容;
  2. .xcconfig的文件的内容,是以key-value形式构成的;
  3. 增加.xcconfig文件后,依然可以继续在build settings里增加配置项目,并不会覆盖;
1.查看配置文件

其实,若使用Cocoapods管理第三方库,就已经自动生成了DebugRelease配置文件。

查看配置:Xcode -> PROJECT -> info -> Configurations

2.自定义配置文件
  1. Commd +N -> 搜索Configuration Setting File,保存名称以"目录名-App名.环境"为格式, 如"Config-TestProject.debug";
  2. .xcconfig文件里写入配置,而这里用到的key其实都是build settings配置选项的缩写,具体可查看网站Xcode Build Settings

举例:在配置文件中写入以下配置:

SLASH = /
HOST_URL = http:${SLASH}/1234
OTHER_LDFLAGS =  -framework "AFNetworking"
HEADER_SEARCH_PATHS = /abcd/efg
复制代码

此时执行编译后,在build settings里搜索查看Other Linker FlagsHeader Search Paths,这些配置都已经被成功修改;

3.特殊符号问题

在写入配置信息时,其中url//会被认为是注释。此时,我们可以先定义一个变量SLASH = /, 如下代码:

SLASH = /
HOST_URL = http:${SLASH}/5678
复制代码
4.增加约束条件

某些情况下,我们需要为配置增加约束条件,如只在Debug环境下、SDK是模拟器,且架构是x86_64的情况下才会link这个frameworkName,则需要如下配置:

OTHER_LDFLAGS[config=Debug][sdk=iphonesimulator*][arch=x86_64] = -framework "frameworkName"
复制代码
5.xcconfig文件冲突问题

我们习惯于使用cocoapods管理第三方,由其生成的配置文件和我们自定义的配置文件就会冲突,因为一个环境只能配置一个.xcconfig文件:

而且,此时更新Pods也会警告:已经存在其他的配置文件,Pods设置的.xcconfig文件不会生效;

解决方案:在自定义配置文件中使用关键include命令,引入pods的配置文件,使其生效:

//注意:这里需要根据debug、release等不同的环境,分别设置
#include "Pods/Target Support Files/Pods-TestProject/Pods-TestProject.debug.xcconfig"
复制代码
6.xcconfig关键字冲突问题

Pods生成的.xcconfig文件通过include导入自定义的配置文件中后,如果两者都对同一个key进行过配置,就会导致前者无效的问题。

比如,两者都对相同的Other Link Flags进行配置,查看Build Setting后,会发现Pods生成的.xcconfig没有生效;

解决方案:使用inherited进行继承,在自定义配置文件中配置如下:

OTHER_LDFLAGS = $(inherited) -framework "AFNetworking"
复制代码
7.测试.xcconfig多环境
  1. 在不同的.xcconfig定义不同的HOST_URL,并以类似上文的步骤在info.plist中增加配置;
  2. 切换到不同的configration下运行项目,将会得到不同的HOST_URL

参考链接

  1. 本文测试Demo地址
  2. iOS多Target开发相似App
文章分类
iOS
文章标签