首先聲明
因為我是在真機上編譯的項目,所以報錯的架構(CPU指令集)為arm64。
如果我們使用64位模擬器(iPhone simulators 5s 或更高版本)編譯或者運行項目,就會報以下錯誤:
Undefined symbols for architecture x86_64:
如果我們使用32位模擬器(iPhone simulators 5 或更低版本)編譯或者運行項目,就會報以下錯誤:
Undefined symbols for architecture i386:
Undefined symbols for architecture XXX:類似的錯誤是一個開發中經常遇到的問題,凡是涉及到第三方靜態庫的項目,都不可避免的遇到過這一類錯誤。為了說明錯誤的原因和加深對解決方案的理解。筆者采用了故意復現問題的方式來驗證問題的解決方案:
即:故意給工程進行錯誤的配置或者刪除某些配置,使工程編譯不通過,然後記下編譯器報的錯誤,驗證什麼情況下會報這種錯。
首先聲明,我的工程中引用(並非通過cocoapods引用)了友盟的統計SDK,名稱叫做libMobClickLibrary.a。存儲在工程的third_party目錄下,如下圖:
靜態庫目錄
原因之一:沒有鏈接lib庫而報錯
lib是library的意思,lib庫就是指後綴名為.a的靜態庫。
(1) 刪除General -> Linked Frameworks and Libraries 下的libMobClickLibrary.a。如下圖分別是刪除前和刪除後的對比:
刪除前:
此時鏈接了靜態庫
刪除後:
此時不再鏈接靜態庫
(2) 再次真機編譯項目,我們就能如願以償的看到兩個經典的的錯誤 "OBJC_CLASS$_MobClick", referenced from: 和 linker command failed with exit code 1 (use -v to see invocation),點擊第一個錯誤,如下圖:
Snip20161219_11.png
(3)然後看到 Undefined symbols for architecture arm64:
Snip20161219_4.png
但是我們怎麼知道是沒有鏈接libMobClickLibrary.a庫而不是其他的什麼庫呢?這還要取決於這句"_OBJC_CLASS_$_MobClick", referenced from:。其中_OBJC_CLASS_$_MobClick中的MobClick就是我們引用的libMobClickLibrary.a中的一個文件。因為我真的是在AliyunSalesCustomerListTableViewManager.m中通過#import "MobClick.h"引用了MobClick.h,如下圖:
Snip20161219_12.png
當然,如果我們引用了libMobClickLibrary.a庫中的其他文件,那麼OBJC_CLASS$_後面就不是MobClick了,這個大家應該是很好理解的。
有的時候,因為後面的類名跟第三方的庫名沒有任何相似處,比如庫名叫做libAAA.a,而報錯的類名卻是BBB。此時,我們通過後面的類名根本不能准確的判斷出這個BBB屬於哪個庫,也就不知道該鏈接哪個庫。這種情況下,我們可以通過referenced from:提示後面的文件名來判斷BBB到底屬於哪個靜態庫,因為我們自己的某個類文件不太可能import很多第三方的庫,這種情況下,采取這種方式比較好判斷。
總結:綜上,我們可知:項目中如果用到了某個第三方靜態庫,但lib靜態庫或者framework靜態庫沒有被鏈接時,就會遇到Undefined symbols for architecture XXX這一類的錯誤。
原因:編譯項目時,因為靜態庫沒有鏈接進工程,所以靜態庫就不會參與編譯,而項目某些文件(.m文件)又引用(或者說依賴)了靜態庫,所以自然會報錯,而報的錯就是經典的 Undefined symbols for architecture XXX這一類的錯誤。
解決方案:下次遇到這類問題,我們只需要在Linked Frameworks and Libraries 中添加指定的靜態庫即可!
還原項目
因為剛才刪除了libMobClickLibrary.a文件,我們要想讓項目可以恢復到完美編譯運行的狀態,需要在Linked Frameworks and Libraries 添加libMobClickLibrary.a庫,如下圖:
因為是第三方庫,不是系統提供的庫,所以需要到我們自己的目錄中添加:如下圖展示了添加步驟:
第一步:點擊添加
第二步:點擊Add Other
第三步:選中靜態庫點擊open
至此,缺失的靜態庫已經被鏈接進工程中,再次編譯項目就不會報這個錯誤。當然,如果還報類似錯誤,說明你的項目中還需要鏈接其他的靜態庫,鏈接方法相同。
原因之二:沒有鏈接.framework靜態庫而報錯
上面說明了工程中因為缺少鏈接lib庫導致報錯的一種情況。iOS開發中有兩種格式的靜態庫(.a格式和.framework格式)。所以,我們也不難猜測:缺少鏈接.framework格式的靜態庫也會導致同樣的錯誤。
如果我們引用的第三方庫並不是.a格式的靜態庫,而是.framework格式的靜態庫,在Linked Frameworks and Libraries中沒有被鏈接的情況下,也會報同樣的錯誤。比如我在Linked Frameworks and Libraries 中刪除 PushCenterSDK.framework靜態庫(這個靜態庫存在於木紋中,不是cocoapods管理的),如下圖:
(1)在Linked Frameworks and Libraries中刪除PushCenterSDK.framework
刪除.framework靜態庫
(2)模擬器編譯項目,出現以下三個錯誤:
因為缺少鏈接的靜態庫所以編譯出現錯誤
(3)點擊第一個錯誤,查看錯誤詳情,如下圖:
錯誤詳情
發現:如果缺少鏈接.framework格式的靜態庫,也會報相同的錯誤,所以,不管我們缺少鏈接的是.a靜態庫還是.framework靜態庫,只要在Link Frameworks and Libraries 中沒有正確鏈接進去,都會報相同的錯誤,即:Undefined symbols for architecture XXX:。
值得注意的是,此處報了三個錯誤,原因在於,YunFuPushCenter.m文件中引用了PushCenterSDK.framework的兩個文件(如下圖),所以會多報一個錯誤,這個是比較好理解的:
引用了framework中的兩個文件
原因之三:extern引用不存在的全局變量而報錯
開發中,我們很有可能用到全局變量,比如在delegate.m文件中定義了一個int 型全局變量globalVar,在ViewController.m文件中通過extern int globalVar; 而引用A.m文件的這個全局變量。這樣是沒問題。但是如果我們不小心把extern int globalVar 寫成 extern int globalVariate,且在ViewController.m文件中使用了這個globalVariate變量(代碼如下)。
#import "AppDelegate.h" @interface AppDelegate () @end @implementation AppDelegate int globalVar; // 生命一個全局變量 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { return YES; }
#import "ViewController.h" @interface ViewController () @end @implementation ViewController extern int globalVariate; // 引用一個不存在的全局變量 - (void)viewDidLoad { [super viewDidLoad]; globalVariate = 10; // 給不存在的全局變量賦值 } @end
編譯上面代碼也會報同樣的錯誤,如下圖:
點擊錯誤查看詳情,如下圖:
原因:因為extern int globalVariate並沒有定義名為globalVariate的變量,而是引用了一個名字叫做globalVariate的全局變量。當我們使用globalVariate時候,系統發現這個變量根本沒有定義,就會報這個錯誤。