xcconfig 基本使用與分析

通過(guò)文件的形式,管理、替代Build Settings,更方便的管理設(shè)置Build Settings。其以Key-Value格式(Build Settings類似shell環(huán)境變量),進(jìn)行編輯。參考官方文檔

創(chuàng)建 -- 后綴名xcconfig
  1. 項(xiàng)目中,command + N 搜索config;
  2. 選擇Configuration Settings File;
  3. Next -- 命名文件名稱;
  4. Create -- 創(chuàng)建完成;
  5. 配置關(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ǔ)法
注釋 -- “//” 兩正斜杠
  1. 單行注釋,注釋整行;
  2. 也可以在設(shè)置值后面;
  3. 與URL中“//”互斥問(wèn)題。

圖2中:URL與 // 問(wèn)題解決:如自定義一個(gè)正斜杠變量TAG_SLASH,在URL引用TAG_SLASH變量

“//”實(shí)現(xiàn)使用


變量 -- 以Key=Value的形式

Key一般以大寫(xiě)字母下劃線分割;可以自定義,也可以使用Xcode已定義好的環(huán)境變量。

  1. 覆蓋變量:變量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

  1. 引?變量: $()${} 兩種寫(xiě)法都可以:
  1. 條件變量:對(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)

  1. 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)。
  2. "、'單雙引號(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”
  • 相對(duì)路徑
    • 相對(duì)于當(dāng)前生成配置文件的位置,生成配置文件的路徑;或以${SRCROOT}的路徑開(kāi)始;
      # include“. . / MyOtherConfigFile.xcconfig” :當(dāng)前文件上一層
      # include“ ${SRCROOT} /Test/MyOtherConfigFile.xcconfig”:當(dāng)前項(xiàng)目根目錄下的Test文件夾里
  • 絕對(duì)路徑
    • 生成配置文件在磁盤(pán)上的絕對(duì)路徑。
      #include "/Users/MyUserName/Desktop/MyOtherConfigFile.xcconfig"

[注意]:如果在生成時(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等

  1. xcconfig文件自定義變量;
  2. Info.plist文件設(shè)置自定義Key,獲取變量;
  3. 代碼使用,用Info.plist獲取。



擴(kuò)展
腳本功能模塊保存在項(xiàng)目.xcodeproj(顯示包內(nèi)容)~> project.pbxproj。所以可以使用腳本注入一些信息,想達(dá)到的操作。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,739評(píng)論 6 534
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 98,634評(píng)論 3 419
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人,你說(shuō)我怎么就攤上這事。” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 176,653評(píng)論 0 377
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我,道長(zhǎng),這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 63,063評(píng)論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 71,835評(píng)論 6 410
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 55,235評(píng)論 1 324
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,315評(píng)論 3 442
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 42,459評(píng)論 0 289
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,000評(píng)論 1 335
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 40,819評(píng)論 3 355
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 43,004評(píng)論 1 370
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,560評(píng)論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,257評(píng)論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 34,676評(píng)論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 35,937評(píng)論 1 288
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 51,717評(píng)論 3 393
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 48,003評(píng)論 2 374

推薦閱讀更多精彩內(nèi)容

  • xcconfig文件,允許我們通過(guò)文件的方式管理Xcode中的Build Setting配置選項(xiàng)。xcconfig...
    iOS慢慢閱讀 684評(píng)論 0 2
  • xcconfig 文件的語(yǔ)法比較簡(jiǎn)單,每個(gè)配置文件都由一系列鍵值分配組成,這些鍵值分配具有以下語(yǔ)法: 一、注釋 x...
    yuebiubiu閱讀 300評(píng)論 0 0
  • 目錄 注釋[#%E6%B3%A8%E9%87%8A] 變量[#%E5%8F%98%E9%87%8F] 優(yōu)先級(jí)[#%...
    differ_iOSER閱讀 1,123評(píng)論 0 15
  • 利用Xcode進(jìn)行開(kāi)發(fā)時(shí)需要進(jìn)行很多build setting的設(shè)置以便能讓項(xiàng)目按照設(shè)置的進(jìn)行編譯,同時(shí)有時(shí)候需要...
    MambaYong閱讀 3,384評(píng)論 0 19
  • 在APP開(kāi)發(fā)中,一般會(huì)存在develop 環(huán)境 ,test環(huán)境,online環(huán)境.一般不同的環(huán)境我們可能需要不同的...
    我的昵稱是小狼閱讀 1,292評(píng)論 0 0