通過(guò)文件的形式,管理、替代Build Settings,更方便的管理設(shè)置Build Settings。其以Key-Value格式(Build Settings類似shell環(huán)境變量),進(jìn)行編輯。參考官方文檔
創(chuàng)建 -- 后綴名xcconfig
- 項(xiàng)目中,command + N 搜索config;
- 選擇Configuration Settings File;
- Next -- 命名文件名稱;
- Create -- 創(chuàng)建完成;
- 配置關(guān)聯(lián)xcconfig文件,使xcconfig生效。
一個(gè)項(xiàng)目中允許有多個(gè)xcconfig文件,但只有一個(gè)入口,只能配置一個(gè)xcconfig文件,其它xcconfig文件被
#include
到入口文件即可。
可以給Project、Target配置;如圖中步驟4,展開(kāi)Project,就顯示Target,就可以給Target添加配置。配置關(guān)聯(lián)xcconfig文件(入口),圖中為Debug環(huán)境下給Project設(shè)置
語(yǔ)法
注釋 -- “//” 兩正斜杠
- 單行注釋,注釋整行;
- 也可以在設(shè)置值后面;
- 與URL中“//”互斥問(wèn)題。
圖2中:URL與 // 問(wèn)題解決:如自定義一個(gè)正斜杠變量TAG_SLASH,在URL引用TAG_SLASH變量
“//”實(shí)現(xiàn)使用
變量 -- 以Key=Value的形式
Key一般以大寫(xiě)字母下劃線分割;可以自定義,也可以使用Xcode已定義好的環(huán)境變量。
-
覆蓋變量:變量Key與Xcode一致時(shí)。會(huì)出現(xiàn)覆蓋,如高優(yōu)先級(jí)覆蓋低優(yōu)先級(jí)、先執(zhí)行被后執(zhí)行覆蓋。可以通過(guò)
${inherited}
,讓當(dāng)前變量值繼承原有值。例如:
OTHER_LDFLAGS = -framework Masonry
OTHER_LDFLAGS = $(inherited) -framework AFNetworking
// OTHER_LDFLAGS = -framework Masonry -framework AFNetworking
注意
:有部分變量不能通過(guò) xcconfig 配置到 Build Settings 中,例如:配置PRODUCT_BUNDLE_IDENTIFIER 不起作?。
獲取Xcode定義好的環(huán)境變量Key
-
引?變量:
$()
和${}
兩種寫(xiě)法都可以:
- 條件變量:對(duì)SDK 、 Arch 和 Configration 對(duì)設(shè)置進(jìn)?條件化
1 //指定`Configration`是`Debug`
2 // 指定`SDK`是模擬器,還有iphoneos*、macosx*等
3 // 指定?效架構(gòu)為`x86_64`
OTHER_LDFLAGS[config=Debug][sdk=iphonesimulator*][arch=x86_64]=
$(inherited) -l AFNetworking
注意
:在 Xcode 11.4 及以后版本,可以使? default ,來(lái)指定變量為空時(shí)的默認(rèn)值:
$(BUILD_SETTING_NAME:default=value)
-
Value類型 常見(jiàn)的有如下:
- Boolean:YES or NO;
- string:字符串,指定的文本值;
- enumeration (string):枚舉,預(yù)定義的文本值;
- string list:字符串列表,以空格分隔的字符串值列表。如果字符串列表中的字符串包含空格,則字符串必須用引號(hào)括起來(lái);
- path:路徑,POSIX格式的文件或目錄路徑;
- path list:路徑列表,用空格分隔的路徑值列表。如果路徑列表中的路徑包含空格,則路徑必須用引號(hào)括起來(lái)。
"、'單雙引號(hào)表示字符串
雙引號(hào)、單引號(hào)表示字符串
執(zhí)行腳本
- Xcode執(zhí)行腳本的配置
腳本的配置;執(zhí)行Shell語(yǔ)言的echo命令輸出設(shè)置的xcconfig值在Xcode的終端輸出執(zhí)行結(jié)果由于查看腳本結(jié)果每次到Xcode終端查看編譯記錄,Xcode終端和Mac上的終端都是Shell環(huán)境,所以把執(zhí)行的腳本結(jié)果重定位到Mac終端上。
-
重定位
把Xcode執(zhí)行Shell語(yǔ)言的結(jié)果在Mac終端上輸出- “1”:獲取當(dāng)前執(zhí)行shell命令的標(biāo)準(zhǔn)輸出(無(wú)語(yǔ)法錯(cuò)誤的輸出);
- “>”:重定位符;
- 獲取終端標(biāo)識(shí)符:輸入“tty”
獲取當(dāng)前終端的標(biāo)識(shí)符第五行的執(zhí)行結(jié)果重定位到終端上在終端輸出結(jié)果
鏈接 .a庫(kù)
-
配置頭文件 -- 編譯.o文件生效
HEADER_SEARCH_PATHS = ${SRCROOT}/MyXconfig/Libs
-
庫(kù)所在目錄 -- 符號(hào)信息
LIBRARY_SEARCH_PATHS = ${SRCROOT}/MyXconfig/Libs
-
鏈接器連接庫(kù) -- 鏈接器生成可執(zhí)行文件(需要符號(hào)的具體信息,在.a的庫(kù)里 );“-l”參數(shù):表示庫(kù)library;多個(gè)庫(kù)用空格。
OTHER_LDFLAGS = -lAFNetworking -lMasonry
鏈接.a庫(kù) 三步驟
配置完成頭文件
配置Build Settings優(yōu)先級(jí)
Target > Target-xcconfig > Project > Project-xcconfig。BuildSettings默認(rèn)繼承 ${inherited}
- Target 配置Build Settings
- Target 配置xcconfig文件
- Project 配置Build Settings
- Project 配置xcconfig文件
Target中刪除HEADER_SEARCH_PATHS,xcconfig設(shè)置失效;或者導(dǎo)入其它庫(kù)會(huì)覆蓋xcconfig的值
- 如果Project和Target都添加了同一個(gè)xcconfig文件,此時(shí)xcconfig文件屬于Target的xcconfig
- 需要使用關(guān)鍵字
${inherited}
關(guān)鍵字繼承 -- ${inherited}、包含/導(dǎo)入 -- #include
繼承 -- ${inherited}
在不同文件中,存在優(yōu)先級(jí)關(guān)系時(shí),同一個(gè)key時(shí)高優(yōu)先級(jí)會(huì)覆蓋掉低優(yōu)先級(jí)的value。一般開(kāi)發(fā)中,設(shè)置的value是一起存在。所以就需要使用 ${inherited},解決該種問(wèn)題。存在優(yōu)先級(jí)關(guān)系有:
- 配置Build Settings優(yōu)先級(jí)
- 多個(gè)xcconfig中(例如:a文件引入b文件,此時(shí)a的文件比b文件高,其實(shí)以內(nèi)容的執(zhí)行順序有關(guān),會(huì)直接覆蓋之前的內(nèi)容)
在Target中添加${inherited},就把xcconfig同一Key值繼承過(guò)來(lái)
包含/導(dǎo)入 -- #include
配置多個(gè)xcconfig文件,但引入xcconfig的入口只有一個(gè),所以此時(shí)需要使用上關(guān)鍵字#include。[注意]:多個(gè)xcconfig文件,同一個(gè)key會(huì)產(chǎn)生覆蓋,就需要使用“${inherited}”繼承。引用三種方式,如下:
-
文件名
- 與當(dāng)前生成配置文件位于同一文件夾中的生成配置文件的名稱;
# include“MyOtherConfigFile.xcconfig”
- 與當(dāng)前生成配置文件位于同一文件夾中的生成配置文件的名稱;
-
相對(duì)路徑
- 相對(duì)于當(dāng)前生成配置文件的位置,生成配置文件的路徑;或以
${SRCROOT}
的路徑開(kāi)始;
# include“. . / MyOtherConfigFile.xcconfig”
:當(dāng)前文件上一層
# include“ ${SRCROOT} /Test/MyOtherConfigFile.xcconfig”
:當(dāng)前項(xiàng)目根目錄下的Test文件夾里
- 相對(duì)于當(dāng)前生成配置文件的位置,生成配置文件的路徑;或以
-
絕對(duì)路徑
- 生成配置文件在磁盤(pán)上的絕對(duì)路徑。
#include "/Users/MyUserName/Desktop/MyOtherConfigFile.xcconfig"
- 生成配置文件在磁盤(pán)上的絕對(duì)路徑。
[注意]:如果在生成時(shí)沒(méi)有找到指定的文件,則會(huì)生成生成警告。要消除對(duì)丟失構(gòu)建配置文件的警告,請(qǐng)?jiān)?include前綴后加上問(wèn)號(hào)(?)。
#include? "MyOtherConfigFile.xcconfig"
-
Cocoapods
項(xiàng)目中使用cocoapods管理,其就有用xcconfig配置Build Settings。而自己添加xcconfig文件時(shí)。就把引入xcconfig文件入口選擇自己的xcconfig,并在里面#include
cocoapods的xcconfig文件路徑。
項(xiàng)目里訪問(wèn)xcconfig值
目前只能用Info.plist** 打開(kāi)Info.plist可以訪問(wèn)Build Settings里的變量值。如:Bundle name/identifier等
- xcconfig文件自定義變量;
- Info.plist文件設(shè)置自定義Key,獲取變量;
- 代碼使用,用Info.plist獲取。
擴(kuò)展
腳本功能模塊保存在項(xiàng)目.xcodeproj(顯示包內(nèi)容)~> project.pbxproj。所以可以使用腳本注入一些信息,想達(dá)到的操作。