把第三方靜態庫或 Framework 直接拖進工程、編譯通過,就等於配置正確了嗎?未必。一旦把工程發給同事,或者換一台機器,那些寫死的絕對路徑立刻變成噩夢。這篇把 Xcode 的搜索路徑配置講清楚。
參考資料:Apple 官方 Build Setting Reference
我們在 Xcode 中配置頭文件搜索路徑時,通常會寫成類似 /Users/yourname/Projects/xxx/Headers 這樣的形式。自己用確實沒問題,但只要工程換了位置、換了開發者,這個路徑就失效了 —— 編譯報找不到頭文件,而接手的人還得先去問你「你電腦上的文件放哪」。這就是絕對路徑的原罪。
Xcode 提供兩個容易混淆的設置項,先說 Header Search Paths:顧名思義,它存放的是工程中頭文件的搜索根路徑。那些沒有被加入項目的頭文件,可以透過配置 Header Search Paths 引入,好處是不必把所有文件都拖進 project,便於管理。
兩者的區別可以從 C 的引用語法理解:
#include <file.h> // 只從 Header Search Paths 中搜索 #include "file.h" // 從 Header Search Paths 和 User Header Search Paths 中搜索
也就是說,如果某個路徑只加到了 User Header Search Paths,那麼用 #include <file.h> 引入時會報錯;加到 Header Search Paths 則兩種寫法都沒問題。
更本質的解釋是:尖括號代表從系統目錄空間搜索(對應 Header Search Paths),雙引號代表從用戶目錄空間搜索(對應 User Header Search Paths)。路徑加在 User 一側,而尖括號不會去用戶空間找,自然失敗。
正確做法是把路徑寫成相對形式:
"$(SRCROOT)/當前工程名字/需要包含頭文件所在文件夾"
把這串字符貼進去之後你會發現,$(SRCROOT) 會自動展開為當前工程的所在目錄。這樣工程發給任何人、放在任何位置,路徑都成立,對方完全不需要改配置。
#include <> 引用編譯器的類庫路徑下的頭文件 #include "" 引用工程目錄的相對路徑頭文件
#include 是編譯指令,編譯時編譯器會把相對路徑替換成絕對路徑。因此:
頭文件絕對路徑 = 搜索路徑 + 相對路徑
搜索路徑在 Xcode → Build Settings → Search Paths 中設置。
$(SRCROOT) 與 $(PROJECT_DIR) 都指向 xxx.xcodeproj 所在的父目錄,實務中兩者可以互換使用。
假設要引用 testDemo/scr/test.h:
$(SRCROOT),則引用寫法為 #include "scr/test.h"$(SRCROOT)/scr,則可以直接寫 #include "test.h"歸納一下規律:搜索路徑寫到哪一層,引用時就從下一層開始寫。路徑寫得越深,代碼裡的引用就越短,但也更容易與其他庫的頭文件重名,需要權衡。
Library Search Paths 中同樣要用相對路徑:
$(inherited) "$(SRCROOT)/xxx.a所在的文件名"
有多個 .a 文件時,格式如下:
$(inherited) "$(SRCROOT)/xxxx" "$(SRCROOT)/xx"
$(inherited) 的作用是繼承上層配置項的值,避免你在子 target 中自定義時把父層的配置覆蓋掉 —— 這一步經常被漏寫,導致依賴項突然找不到。
如果這裡取的是絕對路徑,工程一移動就可能編譯出錯,所以務必改成相對路徑。
設置為 -ObjC。當導入的靜態庫中使用了 Objective-C 的類別(Category)時,必須加上這個標記,否則運行時會出現 unrecognized selector 崩潰。
如果只想讓部分庫生效、避免全域加載帶來的包體膨脹,可以改用 -force_load 加具體的庫路徑:
-ObjC -force_load "$(SRCROOT)/libs/libxxx.a"
$(inherited)」當成默認寫法。