GDataXML 是 Objective-C 中常見的 XML 解析工具,特別是在需要讀取結構化 XML 資料時很實用。不過在 ARC 專案中使用時,需要額外設定,否則容易出現編譯或連結錯誤。
通常會需要 GDataXML 的實作檔與相關定義檔。下載後,把 GDataXML.h、GDataXML.m 以及必要的 defines 與 namespace 標頭檔加入專案。
若專案使用 ARC,GDataXML.m 需要加上非 ARC 編譯旗標,例如 -fno-objc-arc。這樣該檔案才能以手動記憶體管理方式編譯。
需要加入系統的 libxml2.dylib。接著在 Build Settings 中設定 Header Search Paths,加入 /usr/include/libxml2。Other Linker Flags 也要加入 -lxml2,讓連結器能找到 XML 函式庫。
使用時,可先從 bundle 或檔案路徑取得 XML 資料,建立 NSData 物件,再用 GDataXMLDocument 初始化。取得根節點後,可用 elementsForName 取得子節點,再用 attributeForName 或 stringValue 取得屬性與文字內容。
例如一份使用者 XML 可能包含多個 User 節點,每個 User 底下有 name 與 age。解析時,先取得所有 User 節點,再逐一取出屬性與子節點值即可。
GDataXML 雖然方便,但屬於較早期的工具。若專案是新出爐的,也可以評估是否改用系統內建或其他現代 XML 解析方案。若維護舊專案,則只要把 ARC、libxml2 與 Header Search Path 設定正確,就能順利使用。