在 iOS 專案中引入 Google 的 GDataXML 類庫來解析 XML 時,編譯階段相當常見到以下連結錯誤:
Undefined symbols:
"_kGDataXMLXPathDefaultNamespacePrefix", referenced from:
_kGDataXMLXPathDefaultNamespacePrefix$non_lazy_ptr in GDataXMLNode.o
(maybe you meant: _kGDataXMLXPathDefaultNamespacePrefix$non_lazy_ptr)
ld: symbol(s) not found for architecture i386
clang: error: linker command failed with exit code 1
這個錯誤的本質是「符號找不到定義」,而不是程式邏輯有問題。最常見的成因是:GDataXMLNode.h 被以「字串」形式引入(#import "GDataXMLNode.h"),但實際上 GDataXML 是一個 framework,必須以角括號方式引入,才會讓編譯器正確產生對 framework 內符號的連結需求。
把 .h 檔中的引入方式從:
#import "GDataXMLNode.h"
改為:
#import <GDataXML/GDataXMLNode.h>
也就是把引號換成角括號,並把這行 import 從 .m 檔移到 .h 檔中,同時確認 GDataXML 的 header 路徑已正確加入 Header Search Paths。
若改完仍然報錯,請依序確認:
1. libxml2 是否已加入——GDataXML 底層依賴 libxml2,需在 Build Phases 的 Link Binary With Libraries 中加入 libxml2.dylib(或 .tbd)。
2. Header Search Paths——需加入 /usr/include/libxml2,並勾選 recursive。
3. Other Linker Flags——加入 -lxml2。
4. 檔案是否真的被編譯——檢查 Target Membership,確認 GDataXMLNode.m 有被勾選編譯;若 .m 檔不在專案內,符號自然不存在。
以上四點是這個錯誤的標準排查順序,實務上絕大多數案例都能在第二步到第四步之間找到答案。