原文鏈接 :http://www.cocoachina.com/ios/20170221/18737.html
首先聲明
因為我是在真機上編譯的項目,所以報錯的架構(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變量(代碼如下)。
1
2
3
4
5
6
7
8
9
10
11
12
#import?"AppDelegate.h"
@interface?AppDelegate?()
@end
@implementation?AppDelegate
int?globalVar;?//?生命一個全局變量
-?(BOOL)application:(UIApplication?*)application?didFinishLaunchingWithOptions:(NSDictionary?*)launchOptions?{
????returnYES;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
#import?"ViewController.h"
@interface?ViewController?()
@end
@implementation?ViewController
extern?int?globalVariate;?//?引用一個不存在的全局變量
-?(void)viewDidLoad?{
????[superviewDidLoad];
????globalVariate?=?10;?//?給不存在的全局變量賦值
}
@end
編譯上面代碼也會報同樣的錯誤,如下圖:
點擊錯誤查看詳情,如下圖:
原因:因為extern int globalVariate并沒有定義名為globalVariate的變量,而是引用了一個名字叫做globalVariate的全局變量。當我們使用globalVariate時候,系統發現這個變量根本沒有定義,就會報這個錯誤。