一、配置的初衷:每次app在Release和Debug模式下都要来回改正式与测试的 BaseUrl
以及其他的url
或者常量,有可能忘记改,我们就上线,结果就可想而知,于是为了避免手动更改的麻烦和犯错误,我们才去配置环境
二、通过Debug和Release代码的判断来配置,如下
#ifdef DEBUG
#define BaseURL @"https://test.app/api/"
#else
#define BaseURL @"https://app/api/"
#endif
- 建议:把上述代码放在一个单独的
.h
文件里面,在需要使用的时候导入头文件即可,这样会更加简洁,职能更加专一,更好维护,但是这不是最好的方式,最好的方式通过Xcode
中的Configurations Setting Fil(.xcconfig)
来解决,这应该是最优的实现方式,从而根据Debug和Release来选择相应的环境,看下面三
的配置
三、Configurations Setting Fil(.xcconfig)的配置步骤
-
3.1、创建三个 Configuration Settings File 文件,该文件的后缀为
.xcconfig
, 三个文件的命名分别命名为Common.xcconfig
,Debug.xcconfig
,Release.xcconfig
, 其中Debug.xcconfig
和Release.xcconfig
可以使用#include
来包含Common.xcconfig
配置文件, 注意在创建.xcconfig
的时候Xcode默认是不会选中Targets的,注意要选中!提示:
Common.xcconfig
,Debug.xcconfig
,Release.xcconfig
三个文件的名字自己可以随便起,不想改就以这三个名字就好,下面我就把这三个名字前都加上JK
,如:JKCommon.xcconfig
,JKDebug.xcconfig
,JKRelease.xcconfig
-
3.2、下面以
`JKCommon.xcconfig` 为例创建JKCommon.xcconfig
为例创建,JKDebug.xcconfig
和JKRelease.xcconfig
一样
`JKCommon.xcconfig` 为例创建
配置后的图 -
3.3、Debug 和 Release 模式下对上面 文件的的配置
Debug 和 Release 模式下对上面 文件的的配置
把工程切换到PROJECT
—>info
—>Configurations
下,分别 配置Debug和Release模式 下对应的.xcconfig
配置文件,当创建了.xcconfig文件后,在每个模式下自动作为一个选项来选择,这样直接选择.xcconfig对应的文件名字即可
-
3.4、在
JKDebug.xcconfig
和JKRelease.xcconfig
中配置一些url
-
JKDebug.xcconfig
配置#include "JKCommon.xcconfig" // 测试下基础的URL JKURL = @"https:/$()/test.com/api/api/" // 是测试的环境 JK_IS_PRODUCATION = NO
-
JKRelease.xcconfig
配置#include "JKCommon.xcconfig" // 正式下基础的URL JKURL = @"https:/$()/app.com/api/api/" // 是正式的环境 JK_IS_PRODUCATION = YES
提示:在
//
之间使用$()
来转义,如:JKURL = @"https:/$()/app.com/api/api/"
-
-
3.5、在
JKCommon.xcconfig
中配置相应的JKURL
与JK_IS_PRODUCATION
,如下
在 `JKCommon.xcconfig`中配置相应的 `JKURL` 与 `JK_IS_PRODUCATION`GCC_PREPROCESSOR_DEFINITIONS = $(inherited) JKURL='$(JKURL)' JK_IS_PRODUCATION='$(JK_IS_PRODUCATION)'
提示:
-
Common.xconfig
中第一个键的配置必须有 :GCC_PREPROCESSOR_DEFINITIONS = $(inherited)
,没有Xcode会报错 - 自定义键时的语法:
宏名='$(key)'
, 在代码或其他地方使用宏名来引用,'$(key)'
:通过key来指定每个模式下的对应的自定义键的名字,通常将宏的名字和key的名字保持一致,注意 等号前后一定不能有空格 - 特别注意:``Common.xconfig中第一个key是
GCC_PREPROCESSOR_DEFINITIONS = $(inherited)
后面跟自定义的key,注意在第一个key后面跟上自己定义的key的时候一定不要回车换行,敲一个空格,然后在同一行后面追加就行了,换行会编译错误,切记!
-
-
3.6、在
在 `TARGETS` —> `Build Settings` —> `Preprocessor Macros` 下查看自己的配置TARGETS
—>Build Settings
—>Preprocessor Macros
下查看自己的配置,入下
四、上面配置完,我们来测试一下是否好使
-
4.1、在 Debug 模式下测试
NSLog(@"JKURL=%@",JKURL);
打印结果如下
在 **Debug** 模式下测试JKURL=https://test.com/api/api/
-
4.2、在 Release 模式下测试
NSLog(@"JKURL=%@",JKURL);
打印结果如下
在 ** Release** 下测试JKURL=https://app.com/api/api/
-
4.3、上面测试的 demo
五、推荐一些其他的博客,更好的去理解 xcconfig
xcconfig的使用与xcode环境变量
iOS Xcode使用xcconfig配置环境参数(Debug&Release)
网友评论