在 C、C++ 或 Objective-C 專案中,頭檔引用路徑經常造成建置錯誤。Xcode 的 Build Settings 提供了 Search Paths,用來告訴編譯器要去哪裡尋找標頭檔。
使用角括號的 include,通常用來引用編譯器或系統函式庫路徑下的標頭檔。使用雙引號的 include,通常用來引用專案目錄中的相對路徑標頭檔。
編譯時,編譯器會把相對路徑與搜尋路徑組合成絕對路徑。因此,標頭檔能否被找到,取決於 Header Search Paths 是否設定正確。
$(SRCROOT) 與 $(PROJECT_DIR) 通常指向 xxxx.xcodeproj 所在的父目錄。若在 Header Search Paths 加入 $(SRCROOT),就可以用相對路徑引用專案內的檔案。
例如,若要引用 testDemo/scr/test.h,可把 $(SRCROOT) 加入 Header Search Paths,再以 scr/test.h 的方式引用。若直接加入 $(SRCROOT)/scr,則可直接引用 test.h。
若把 Always Search User Paths 設為 yes,編譯器會先搜尋 User Header Search Paths 指定的路徑。這可能導致專案內的同名標頭檔覆蓋系統標頭檔,因此要特別小心。
設定 Search Paths 時,建議使用明確的相對路徑,並避免讓專案標頭檔意外覆蓋系統標頭檔。