您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

iOS 經典報錯 Undefined symbols for architecture XXX 的三種成因與排查

編輯:iOS 開發基礎

凡是用到第三方靜態庫的項目,幾乎都撞過這行報錯:

Undefined symbols for architecture arm64:
Undefined symbols for architecture x86_64:
Undefined symbols for architecture i386:

其中架構名取決於你當前編譯的目標:真機是 arm64(armv7/armv7s 屬於更老的 32 位設備),64 位模擬器是 x86_64,老一點的 32 位模擬器是 i386。

為了把成因說清楚,筆者用「故意把工程改壞」的方式逐一復現了幾種場景。本文示例工程裡以非 CocoaPods 方式引入了友盟統計 SDK(libMobClickLibrary.a)和一個 PushCenterSDK.framework。

靜態庫目錄

成因一:.a 靜態庫沒有被鏈接

所謂 lib 庫,就是後綴為 .a 的靜態庫。把 General → Linked Frameworks and Libraries 裡的 libMobClickLibrary.a 刪掉:

刪除前:

此時靜態庫正常鏈接

刪除後:

此時靜態庫不再被鏈接

重新編譯真機,就會看到兩個經典錯誤:

Undefined symbols for architecture arm64:
  "_OBJC_CLASS_$_MobClick", referenced from: ...
ld: symbol(s) not found for architecture arm64
clang: error: linker command failed with exit code 1 (use -v to see invocation)

點開第一條錯誤查看詳情

Undefined symbols for architecture arm64

怎麼判斷缺的是哪個庫?關鍵在 _OBJC_CLASS_$_MobClick 這一段。MobClick 正是 libMobClickLibrary.a 裡的一個類,而我在 AliyunSalesCustomerListTableViewManager.m 中確實 #import 了 MobClick.h:

工程中引用了 MobClick.h

如果引用的是庫裡別的文件,那麼 $ 後面的類名自然也會跟著變。

有時候庫名和類名完全不搭,比如庫叫 libAAA.a,報錯的類卻是 BBB,這時可以借助 referenced from: 後面提示的源文件反推:某個 .m 文件通常不會 import 一大堆不相干的第三方庫,順著它找就八九不離十。

結論:項目用到了某個第三方靜態庫,但它沒有被添加到 Linked Frameworks and Libraries,編譯時該庫不參與鏈接,而代碼又依賴其中的符號,於是就報了 Undefined symbols for architecture XXX。解法就是把缺失的靜態庫補回鏈接列表。

恢復工程

因為是第三方庫而非系統庫,需要手動從本地目錄添加:

第一步:點擊「+」添加

第二步:選擇 Add Other

第三步:選中靜態庫並 Open

補回之後再次編譯,該錯誤消失。若仍報類似問題,說明還有別的庫沒鏈接,處理方式相同。

成因二:.framework 靜態庫沒有被鏈接

iOS 的靜態庫有兩種形態:.a 和 .framework。所以缺少 .framework 的鏈接,錯誤信息一模一樣。

把 PushCenterSDK.framework 從鏈接列表中刪除:

刪除 .framework 靜態庫

重新編譯:

因為缺少鏈接而報錯

查看詳情:

錯誤詳情

這裡之所以報了三條,是因為 YunFuPushCenter.m 中引用了 PushCenterSDK.framework 裡的兩個文件,每一個未解析符號各算一條:

引用了 framework 中的兩個文件

所以無論缺的是 .a 還是 .framework,只要沒在 Link Binary With Libraries 裡正確鏈接,都會得到同一條報錯。

成因三:extern 引用了一個不存在的全局變量

這一類和靜態庫無關,純粹是代碼層面的筆誤。假設 AppDelegate.m 中定義了全局變量:

@implementation AppDelegate
int globalVar;   // 定義一個全局變量
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    return YES;
}
@end

而在 ViewController.m 中引用時把名字打錯了:

@implementation ViewController
extern int globalVariate;   // 引用一個不存在的全局變量
- (void)viewDidLoad {
    [super viewDidLoad];
    globalVariate = 10;     // 給不存在的變量賦值
}
@end

編譯同樣會報 Undefined symbols:

查看詳情:

原因很直白:extern 只是聲明「這個變量在別處定義」,並不會真正開闢存儲。當全局範圍內找不到 globalVariate 的定義時,鏈接階段自然報未解析符號。把變量名拼對即可。

排查思路小結

  • 先看 referenced from: 提示的類與文件,判斷符號來源於哪個庫;

  • 確認該庫是否出現在 Linked Frameworks and Libraries 中;

  • 若庫已鏈接仍報錯,檢查 Search Path(Framework/ Library Search Paths)是否正確;

  • 若與第三方庫無關,排查 extern 聲明、函數實現是否缺失、C/C++ 的 name mangling 是否匹配。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved