iOS Debug和Release環境的最新配置

weixin_33850890發表於2019-01-18

一、配置的初衷:每次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.xcconfigRelease.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.xcconfigJKRelease.xcconfig一樣

    1728484-2da0624f91a6eb5b.jpg
    `JKCommon.xcconfig` 為例建立

    1728484-185e5578bd089fd0.jpg
    `JKCommon.xcconfig` 為例建立

    1728484-fc98eb05f16756db.jpg
    配置後的圖

  • 3.3、Debug 和 Release 模式下對上面 檔案的的配置
    把工程切換到PROJECT—> info —> Configurations下,分別 配置Debug和Release模式 下對應的 .xcconfig 配置檔案,當建立了.xcconfig檔案後,在每個模式下自動作為一個選項來選擇,這樣直接選擇.xcconfig對應的檔名字即可

    1728484-71c2b157377d73a0.jpg
    Debug 和 Release 模式下對上面 檔案的的配置

  • 3.4、在JKDebug.xcconfigJKRelease.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中配置相應的 JKURLJK_IS_PRODUCATION,如下

    GCC_PREPROCESSOR_DEFINITIONS = $(inherited) JKURL='$(JKURL)' JK_IS_PRODUCATION='$(JK_IS_PRODUCATION)'
    
    1728484-df66fd682db2ccd2.jpeg
    在 `JKCommon.xcconfig`中配置相應的 `JKURL` 與 `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 下檢視自己的配置,入下

    1728484-131f3d98c100ad20.jpeg
    在 `TARGETS` —> `Build Settings` —> `Preprocessor Macros` 下檢視自己的配置

四、上面配置完,我們來測試一下是否好使

  • 4.1、在 Debug 模式下測試

    NSLog(@"JKURL=%@",JKURL);
    

    列印結果如下

    JKURL=https://test.com/api/api/
    
    1728484-17808f1357c4667e.jpeg
    在 **Debug** 模式下測試
  • 4.2、在 Release 模式下測試

    NSLog(@"JKURL=%@",JKURL);
    

    列印結果如下

    JKURL=https://app.com/api/api/
    
    1728484-3a2196d502dfc6e8.jpeg
    在 ** Release** 下測試
  • 4.3、上面測試的 demo

五、推薦一些其他的部落格,更好的去理解 xcconfig

xcconfig的使用與xcode環境變數
iOS Xcode使用xcconfig配置環境引數(Debug&Release)

相關文章