iOS經(jīng)典錯誤library not found for -lXXX

開發(fā)中經(jīng)常會和ibrary not found for -xxx打交道寺渗,尤其是我們從遠程倉庫或者github clone下來一個項目,編譯很有可能報這個錯誤深夯。如下圖:

報錯信息

library not found for -lXXX 屬于iOS經(jīng)典錯誤之一。下面我們通過復(fù)現(xiàn)這個錯誤的方式來說明這個錯誤的解決方法冕房。其中l(wèi)是lib(library)的意思。

首先聲明趁矾,我的工程中引用了友盟的統(tǒng)計SDK毒费,名稱叫做libMobClickLibrary.a。存儲在 third_party目錄下愈魏,如下圖(左圖為libMobClickLibrary.a在工程目錄/虛擬目錄的位置,右圖為libMobClickLibrary.a在磁盤目錄/物理目錄的位置):

工程目錄

磁盤目錄

沒有配置Library Search Paths導(dǎo)致報錯

(1)刪除building setting -> Library Search Paths下的 $(PROJECT_DIR)/YunFu/third_party/UMAnalytics想际。如下圖:
那么培漏,你可能會問,為什么要刪除這個路徑而不是其他的路徑呢胡本?因為我知道這個路徑就是libMobClickLibrary.a靜態(tài)庫的目錄牌柄。

(2)command + B編譯項目,然后不出所料侧甫,我們會遇到下面這個錯誤:


(3)點開這個錯誤珊佣,然后就能看到這個經(jīng)典錯誤,如下圖:
這個錯誤的意思是找不到名字叫做 MobClickLibrary的庫披粟。


至此咒锻,我們可知,就因為我們在Library Search Paths下刪除了$(PROJECT_DIR)/YunFu/third_party/UMAnalytics 導(dǎo)致報這個library not found for -lMobClickLibrary的錯誤守屉。所以下次遇到同類問題惑艇,我們便可知道某個靜態(tài)庫的路徑可能沒有配置。

結(jié)論一:沒有配置靜態(tài)庫的search路徑導(dǎo)致出現(xiàn)library not found for lXXX拇泛。
注意:設(shè)置的路徑必須是靜態(tài)庫在磁盤下的路徑(物理目錄)滨巴,不能設(shè)置為項目的虛擬目錄。拿此例來說俺叭,libMobClickLibrary.a的在項目中是放在third_party文件夾下的恭取,而其真正的磁盤路徑是third_party下的UMAnalytics文件夾。


沒有正確配置Library Search Paths導(dǎo)致報錯

上面的情況是熄守,我們沒有配置某個靜態(tài)庫的路徑會導(dǎo)致library not found for lXXX錯誤蜈垮。而有時候,我們確實在Library Search Paths下配置了靜態(tài)庫路徑柠横,卻依然報同樣錯誤窃款。此時我們就要考慮,這個路徑配置的到底對不對牍氛。如下圖(分別是libMobClickLibrary.a正確的路徑和錯誤的路徑):
正確路徑:


正確路徑

錯誤路徑(去掉了最后一級目錄"/UMAnalytics"):


錯誤路徑

編譯項目依然會報同樣的錯誤library not found for -lMobClickLibrary.a晨继,如下圖:


錯誤信息

歸根到底,原因在于搬俊,我們雖然跟他指定了libMobClickLibrary.a的目錄紊扬,但是在所指定的目錄下沒有搜索到靜態(tài)庫libMobClickLibrary.a蜒茄。此時又分為兩種情況:

  • 情況一:如果我們指定的目錄和靜態(tài)庫libMobClickLibrary.a的目錄完全不相關(guān),那么需要重新到Library Search Paths下設(shè)置(注意:設(shè)置的是靜態(tài)庫的磁盤路徑)餐屎。

  • 情況二:如果我們指定的目錄和靜態(tài)庫的目錄有關(guān)系檀葛。即,我們指定的目錄是靜態(tài)庫所在目錄的上級目錄腹缩,或者是上上級目錄屿聋。這種情況下,無需指定靜態(tài)庫的精確的路徑藏鹊,只需要把non-recursive選項修改為recursive即可润讥。如下圖:

    設(shè)置recursive

因為recursive選項代表在我們指定的目錄下遞歸搜索靜態(tài)庫。即盘寡,如果在當前目錄沒有搜索到靜態(tài)庫楚殿,那么就去當前目錄的子目錄下繼續(xù)搜索。默認情況下是non-recursive(非遞歸)的竿痰。

結(jié)論二:雖然Library Search Paths 中配置了靜態(tài)庫的search路徑脆粥。但是沒有正確配置而導(dǎo)致出現(xiàn)library not found for lXXX。


導(dǎo)入第三方framework靜態(tài)庫編譯報錯xxx.h file not found

上面講的是當我們項目導(dǎo)入的是.a靜態(tài)庫影涉,但因為沒有在 Library Search Paths 中配置.a靜態(tài)庫的search路徑变隔,或者是雖然配置了路徑但是路徑配置錯誤而導(dǎo)致出現(xiàn)library not found for -xxx錯誤的解決辦法。
但我們知道常潮,在iOS中弟胀,靜態(tài)庫有兩種形式:.a格式的靜態(tài)庫和.framework格式的靜態(tài)庫。
那么如果我們的項目中引入了.framework格式的靜態(tài)庫要不要配置search路徑呢喊式?答案是肯定的孵户,無論我們以什么方式導(dǎo)入.framework靜態(tài)庫(cocoapods的方式或者直接把framework靜態(tài)庫拖拽到項目中的方式),如果沒有配置framework的search路徑岔留,同樣會報錯夏哭,但報的錯誤卻是和.a格式的靜態(tài)庫有些不同,如果我們項目中引入了framework格式靜態(tài)庫也使用了靜態(tài)庫(所謂使用就是import了framework靜態(tài)庫中的某個頭文件)献联,但沒有配置search路徑竖配,那么就會報 xxx.h file not found 這類錯誤。如下圖:

xxx file not found

因為我的項目中引入了一個叫做PushCenterSDK.framework的靜態(tài)庫里逆。同時也使用了這個靜態(tài)庫中的某個API进胯。如下圖所示,分別是靜態(tài)庫在項目中的路徑和磁盤路徑:

在項目中的路徑
在磁盤中的路徑

我們依然采用復(fù)現(xiàn)問題的方式來驗證解決錯誤的方法原押,首先胁镐,我的項目是可以編譯通過的,然后嘗試在build setting -> Framework Search Paths 下刪除PushCenterSDK.framework的搜索路徑(磁盤路徑),下圖分別是刪除前和刪除后的截圖:

刪除前:


刪除前

刪除后:


刪除后

刪除路徑之后編譯項目盯漂,發(fā)現(xiàn)出現(xiàn)了如下錯誤XXX.h file not found颇玷, 如下圖:
很顯然,沒有找到PushCenterSDK 下的TBSDKPushCenterEngine.h文件就缆。


報錯

綜上帖渠,framework靜態(tài)庫的路徑也是必須的,如果項目中的framework靜態(tài)庫的路徑配置錯誤或者沒有配置就會報錯 xxx.h file not found 類似錯誤竭宰。下次遇到這類錯誤空郊,便可以從framework search paths 著手思考。

同樣切揭,framework靜態(tài)庫的搜索路徑也支持遞歸搜索渣淳,我們不必配置一個精確無誤的路徑,可以指定一個父級目錄伴箩,然后選擇 recursive。

結(jié)論:無論我們以什么方式導(dǎo)入.framework靜態(tài)庫(cocoapods的方式或者直接把framework靜態(tài)庫拖拽到項目中的方式)鄙漏,如果沒有配置framework的search路徑嗤谚,同樣會報錯,但報的錯誤卻是和.a格式的靜態(tài)庫有些不同怔蚌,如果我們項目中引入了framework格式靜態(tài)庫也使用了靜態(tài)庫(所謂使用就是import了framework靜態(tài)庫中的某個頭文件)巩步,但沒有配置search路徑,那么就會報 xxx.h file not found 這類錯誤


如果有技術(shù)問題桦踊,歡迎加入QQ群進行交流椅野,群聊號碼:194236752。

文/VV木公子(簡書作者)
PS:如非特別說明籍胯,所有文章均為原創(chuàng)作品竟闪,著作權(quán)歸作者所有,轉(zhuǎn)載請聯(lián)系作者獲得授權(quán)杖狼,并注明出處炼蛤,所有打賞均歸本人所有!

如果您是iOS開發(fā)者蝶涩,或者對本篇文章感興趣理朋,請關(guān)注本人,后續(xù)會更新更多相關(guān)文章绿聘!敬請期待嗽上!

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市熄攘,隨后出現(xiàn)的幾起案子兽愤,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,723評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件烹看,死亡現(xiàn)場離奇詭異国拇,居然都是意外死亡,警方通過查閱死者的電腦和手機惯殊,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,485評論 2 382
  • 文/潘曉璐 我一進店門酱吝,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人土思,你說我怎么就攤上這事务热。” “怎么了己儒?”我有些...
    開封第一講書人閱讀 152,998評論 0 344
  • 文/不壞的土叔 我叫張陵崎岂,是天一觀的道長。 經(jīng)常有香客問我闪湾,道長冲甘,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 55,323評論 1 279
  • 正文 為了忘掉前任途样,我火速辦了婚禮江醇,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘何暇。我一直安慰自己陶夜,他們只是感情好,可當我...
    茶點故事閱讀 64,355評論 5 374
  • 文/花漫 我一把揭開白布裆站。 她就那樣靜靜地躺著条辟,像睡著了一般。 火紅的嫁衣襯著肌膚如雪宏胯。 梳的紋絲不亂的頭發(fā)上羽嫡,一...
    開封第一講書人閱讀 49,079評論 1 285
  • 那天,我揣著相機與錄音肩袍,去河邊找鬼厂僧。 笑死,一個胖子當著我的面吹牛了牛,可吹牛的內(nèi)容都是我干的颜屠。 我是一名探鬼主播,決...
    沈念sama閱讀 38,389評論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼鹰祸,長吁一口氣:“原來是場噩夢啊……” “哼甫窟!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起蛙婴,我...
    開封第一講書人閱讀 37,019評論 0 259
  • 序言:老撾萬榮一對情侶失蹤粗井,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體浇衬,經(jīng)...
    沈念sama閱讀 43,519評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡懒构,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 35,971評論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了耘擂。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片胆剧。...
    茶點故事閱讀 38,100評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖醉冤,靈堂內(nèi)的尸體忽然破棺而出秩霍,到底是詐尸還是另有隱情,我是刑警寧澤蚁阳,帶...
    沈念sama閱讀 33,738評論 4 324
  • 正文 年R本政府宣布铃绒,位于F島的核電站,受9級特大地震影響螺捐,放射性物質(zhì)發(fā)生泄漏颠悬。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 39,293評論 3 307
  • 文/蒙蒙 一定血、第九天 我趴在偏房一處隱蔽的房頂上張望椿疗。 院中可真熱鬧,春花似錦糠悼、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,289評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至靖苇,卻和暖如春席噩,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背贤壁。 一陣腳步聲響...
    開封第一講書人閱讀 31,517評論 1 262
  • 我被黑心中介騙來泰國打工悼枢, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人脾拆。 一個月前我還...
    沈念sama閱讀 45,547評論 2 354
  • 正文 我出身青樓馒索,卻偏偏與公主長得像,于是被迫代替她去往敵國和親名船。 傳聞我的和親對象是個殘疾皇子绰上,可洞房花燭夜當晚...
    茶點故事閱讀 42,834評論 2 345

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