開發(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即可润讥。如下圖:
因為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 這類錯誤。如下圖:
因為我的項目中引入了一個叫做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)文章绿聘!敬請期待嗽上!