開發(fā)中經(jīng)常會和ibrary not found for -xxx打交道，尤其是我們從遠(yuǎn)程倉庫或者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)庫。即，如果在當(dāng)前目錄沒有搜索到靜態(tài)庫，那么就去當(dāng)前目錄的子目錄下繼續(xù)搜索。默認(rèn)情況下是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āng)我們項目導(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群進(jìn)行交流，群聊號碼：194236752。
文／VV木公子（簡書作者）
PS:如非特別說明，所有文章均為原創(chuàng)作品，著作權(quán)歸作者所有，轉(zhuǎn)載請聯(lián)系作者獲得授權(quán)，并注明出處，所有打賞均歸本人所有！
如果您是iOS開發(fā)者，或者對本篇文章感興趣，請關(guān)注本人，后續(xù)會更新更多相關(guān)文章！敬請期待！
