iOS使用 xcconfig配置檔案的若干坑

FindCrt發表於2018-10-25

有一些文章介紹.xconfig檔案的使用,如這篇,但是經過親自實踐,發現還是有一些坑,這裡記錄下。

構建新的configuration

這一步在“project-info-configuration”位置進行,點選“+”構建“-”消除,沒什麼問題,這個很簡單也不會出錯。

新建configuration

只是原來使用xcodebuild進行自動打包時的-configuration指的是就是這裡啊。每個專案預設就有的Debug和Release配置。

這個Configuration是對於同一個專案的配置的一個完整的最高的總結了。

使用.xcconfig檔案

新建這個檔案很簡單,xcode自帶了這個模板。然後是在Configuration裡配置,比如在debug時使用First.xcconfigrelease時使用Second.xcconfig,如圖:

螢幕快照 2017-05-13 下午9.22.08.png

這一步也簡單。但是我開始使用的時候,思維就走錯方向了:

根據各種文章的指示,配置檔案(.xcconfig)裡面的內容會覆蓋當前的Build Settings裡面的東西,所以我以為是我在配置檔案裡面寫了一個配置,那麼Build Settings裡面的東西會跟著變。

比如我現在是Debug環境,然後對應的就是First.xcconfig,我在它裡面寫入:

//:configuration = Debug
OTHER_LDFLAGS = -Objcxxx

//:configuration = Release
OTHER_LDFLAGS = -Objcxxx

//:completeSettings = some
OTHER_LDFLAGS
複製程式碼

其實就是Other Linker flags的配置,可是外面Build Settings裡的東西並沒有變。

Build Settings實際樣子

我就暈了,這到底怎麼回事。

這裡有兩個坑

  1. 專案的Build Settings裡直接寫的內容是會優先顯示的,就是說Xcode有一個預設的配置檔案(yourAppName.xcodeproj/project.pbxproj),如果你直接在Build Settings裡編輯,是寫到它裡面去,比如只是修改了other linker flag,再看github的修改:

修改了配置檔案

這個檔案裡的配置會優先在Configuration裡指定的.xcconfig檔案裡的配置,那要怎麼使用.xcconfig檔案裡的配置?刪掉Build Settings裡的配置就好了。Command+delete搞定。

  1. 因為.xcconfig配置檔案很難寫,主要是各種配置名你記不住,所以就到實際的Build Settings裡面去拷貝,就在對應的配置項Command+C就有了,所以內容就變成了上面那樣,我以為3句話是在不同環境下起作用的,是互不干擾的,其實是OTHER_LDFLAGS設了3遍,左後一次生效,最後是啥?空的啊,所以即使刪除了Build Settings裡的內容也不出現,我還以為.xcconfig檔案沒起作用!

    所以改成:OTHER_LDFLAGS = -Objcxxx然後就有了。

    配置檔案生效了

環境切換配置也跟著切換?

首先使用配置檔案的作用就是,在環境切換後,配置可以跟著一整套的切換,.xcconfig就相當於一個把相關的配置打包了。

這裡就有了另一個坑,或者說理解失誤:

我以為是你在Build Configuration裡選擇什麼,那麼Build Settings裡的內容會跟著改變。

Build Configuration修改

實際上Build Settings還是原來那樣,改變的是每一項裡面的內容,比如First.xcconfig配置裡寫入OTHER_LDFLAGS = -Objc_first,而Second.xcconfig裡寫入OTHER_LDFLAGS = -Objc_second,在外面看到的是這樣的:

build settings不變

每一項配置裡面會再分成Debug、Release等不同的Configuration,而不是Build Settings整體切換了。

或者說這是一個結構上的問題,讓新接觸者會改不清楚Xcode到底是什麼做到不同情況使用不同配置的。

整個配置的結構

實際結構是這樣:

  • 最上層就是Project-info-Configuration裡的配置了
  • 然後每個配置裡可以有不同配置檔案(.xcconfig),每個target一個配置檔案
  • 然後是每個配置檔案裡面有許多的配置項

但是在Build Settings的顯示裡,這個結構是倒過來的:

  • 配置檔案
  • 配置項
  • 不同Configuration

另外,關於巨集

在整個Build Settings裡,可以在程式碼裡直接使用的,Preprocess Mcros就是其中之一。

在這裡定義不同的巨集,就可以在程式碼裡由此做不同處理,比如預設的DEBUG巨集就經常用來做條件編譯。

Build Settings裡可以$(xxx)來引用其他配置裡的東西,那麼也就可以在這裡定義巨集並且跟隨其他配置而改變。

相關文章