一、配置的初衷:每次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
爲例創建,JKDebug.xcconfig
和JKRelease.xcconfig
一樣
-
3.3、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
,如下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
下查看自己的配置,入下
四、上面配置完,我們來測試一下是否好使
-
4.1、在 Debug 模式下測試
NSLog(@"JKURL=%@",JKURL);
打印結果如下
JKURL=https://test.com/api/api/
-
4.2、在 Release 模式下測試
NSLog(@"JKURL=%@",JKURL);
打印結果如下
JKURL=https://app.com/api/api/
4.3、上面測試的 demo
五、推薦一些其他的博客,更好的去理解 xcconfig
xcconfig的使用與xcode環境變量
iOS Xcode使用xcconfig配置環境參數(Debug&Release)