iOS xcconfig編寫示例教程

引言

xcconfig文件的語法比較簡單,每個配置文件都由一系列鍵值分配組成,這些鍵值分配具有以下語法:

BUILD_SETTING_NAME = value

註釋

xcconfig文件隻有一種註釋方式,就是//

include導入其他設置

在創建xcconfig文件的時候,可以根據需求,創建多個。也就意味著,可以通過include關鍵字導入其他的xcconfig內的配置。通過include關鍵字後接上雙引號,如下例:

#include "Debug.xcconfig"

在搜索引入的文件時,如果是以/開頭,代表絕對路徑,例如:

// 表示確切的文件位置
#include "/Users/ws/Desktop/LoginApp-沖突/Pods/Target Support Files/Pods-LoginApp/Pods-LoginApp.debug.xcconfig"

或者通過相對路徑,以${SRCROOT}路徑為開始:

#include "Pods/Target Support Files/Pods-LoginApp/Pods-LoginApp.debug.xcconfig"

變量

變量定義,按照OC命名規則,僅由大寫字母,數字和下劃線(_)組,原則上大寫,也可以不。字符串可以是"也可以是'號。

變量有三種特殊情況:

  • xcconfig中定義的變量與Build Settings的一致,那麼會發生覆蓋。可以通過$(inherited),讓當前變量繼承變量原有值。例如:
OTHER_LDFLAGS = -framework SDWebImage
OTHER_LDFLAGS = $(inherited) -framework AFNetworking
// OTHER_LDFLAGS = -framework SDWebImage -framework AFNetworking

註意⚠️:有部分變量不能通過xcconfig配置到Build Settings中,例如:配置PRODUCT_BUNDLE_IDENTIFIER不起作用。

  • 引用變量,$()${}兩種寫法都可以:
VALUE=Cat
TEACHER=$(VALUE)-${VALUE}
  • 條件變量,根據SDKArchConfigration對設置進行條件化,例如:
// 指定`Configration`是`Debug`
// 指定`SDK`是模擬器,還有iphoneos*、macosx*等
// 指定生效架構為`x86_64`
OTHER_LDFLAGS[config=Debug][sdk=iphonesimulator*][arch=x86_64]= $(inherited) -framework "Cat"

註意⚠️:在Xcode 11.4及以後版本,可以使用default,來指定變量為空時的默認值:

$(BUILD_SETTING_NAME:default=value)

優先級(由高到低)

  • 手動配置Target Build Settings
  • Target中配置的xcconfig文件
  • 手動配置Project Build Settings
  • Project中配置的xcconfig文件

以上就是iOS xcconfig編寫示例教程的詳細內容,更多關於iOS xcconfig編寫的資料請關註WalkonNet其它相關文章!

推薦閱讀: