使用Xcconfig配置多个环境及环境变量
在没有配置多个环境的时候,在上架和测试这两种情况下常常需要不断的切换许多环境参数,比如正式接口和测试接口,输出日志和不输出日志,测试app名字和正式app名字等。这些本应该是切换成不同环境时自动配置好的,所以使用Xcconfig来配置多个开发环境,比如上架的环境,测试的环境,开发的环境等。其实CocoaPods就是使用xcconfig来配置的。
参考文档:http://www.jianshu.com/p/9b8bc8351223 (简书)
1、首先系统自带Debug和Release两种环境,如果不足够的话可以新建一个环境
Project -> Info -> Configurations 点击下方的+号,选择第一个或者第二个都可以。
此处命名为XTTest
2、生成Xcconfig配置文件,因为有Debug,XTTest,Release三个环境,所以需要生成三个配置文件,但一般需要再生成另外一个配置文件存放通用的配置,如build version等配置。
工程目录右键New File,选择下图中的Configuration Setting File文件
以下是生成的四个文件(命名最好和环境的名字相同,方便查看)
3、在Project -> Info -> Configurations中配置好相应的xcconfig配置文件,如图。
4、在Debug.xcconfig、XTTest.xcconfig、Release.xcconfig文件中#include “CommonConfig.xcconfig"这个通用配置文件。(为了使每个环境下都能使用这个通用配置文件)
5、如果工程不需要Pods,忽略该步骤 ; 如果工程已经使用Cocoapod(即已经存在Pods)(如果此时才开始使用pods也是可以的,按使用命令窗口来使用pod的步骤来,记得最后pod install就好,不会有影响,后面的“ 在命令窗口cd到该工程路径,然后输入pod install后回车 ”可以忽略),在命令窗口cd到该工程路径,然后输入pod install后回车; 命令窗口会有如下提示:
原因是因为pods的xcconfig配置文件并没有引入,把上面红线的文字copy引入到对应的刚才新建的Debug.xcconfig、XTTest.xcconfig、Release.xcconfig配置文件中就好。
(注意:如果想把系统自带的Debug或者Release环境改成别的名字,需要在改完名字后重新pod install,然后再把提示的黄色字体的相关内容修正到对应的xcconfig文件中)
如Debug.xcconfig配置文件示例:
三个都配置完成后可以再pod install一次,会发现不再显示上面黄色的提示,表示配置成功。
6、此时可以在刚新建的四个配置文件中添加相关环境变量了
Debug.xcconfig
XTTest.xcconfig
Release.xcconfig
CommonConfig.xcconfig
7、此时可以测试不同环境下app的名字是否能自动改变了;在info.plist文件中修改Bundle name内容为${APP_DISPLAY_NAME}(APP_DISPLAY_NAME 是那个变量名)
在下图中选择 Edit Scheme
选择Run中选择XTTest环境,运行程序
app名字显示如下,说明App名字现在可根据工程的环境自动改变名字
(Bundle Identifier自动改变也是一样的操作。比如希望可以在一部手机上分别装3个一样的APP,分别是测试版,预发版,正式版,此时就需要3个不一样的Bundle ID,可以去apple developer网站再去注册另外两个Bundle ID。但需要注意的是,如果使用了极光推送等需要绑定Bundle ID的,则会有两个APP收不到推送,因为Bundle ID不一样嘛。所以建议是如果使用绑定Bundle ID的第三方时,就不要使用多个环境多个Bundle ID的方式,即不能同时装三个APP了。)
8、如何使工程中某些变量的值也能根据环境改变而自动改成相应的值?
Project -> Build Setting 搜索 Swift compiler - Custom Flags
Active Compilation Conditions是Xcode8新增的配置环境参数的参数,之前使用的是 Other Swift Flags ,所以现在Active Compilation Conditions 和 Other Swift Flags 都可以配置环境参数,但在Other Swift Flags 中配置时前面需要加上 -D .
有三种使用方式
(1)使用Active Compilation Conditions ,不使用Other Swift Flags(红框内的字符串并没有要求必须是什么内容,但待会会用到,最好和那三个xcconfig配置文件的名字一样,统一)。
(2)使用Other Swift Flags ,不使用Active Compilation Conditions(红框内的字符串并没有要求必须是什么内容,-D前缀必须加上,但待会会用到,最好和那三个xcconfig配置文件的名字一样,统一)。
(3)同时使用Active Compilation Conditions 和 Other Swift Flags(最好使用第一种,第二种)
以上三种方式亲测有效。
9、新建一个专门配置环境变量的类
图中的webServerURL变量就能自动根据环境改变而返回相应的值了
使用第一种方式,然后使用print("(AppConfig.webServerURL)”)测试一下
环境选择XTTest
输出
配置成功!