靜態庫中定義 `XXViewController`,主工程 XIB/Storyboard 將視圖控制器 Class 設為 `XXViewController`,運行時報警告:
Unknown class XXViewController in Interface Builder file.
視圖控制器無法正確實例化,Outlet/Action 失連,介面空白或崩潰。
靜態庫編譯時,預設**不包含分類方法、類別元數據**等符號。Interface Builder 讀取 XIB/Storyboard 時,通過字串類名動態創建類別 (`NSClassFromString`),若符號未鏈接進主二進制,類別不可見。
-ObjC -all_load
| 標誌 | 作用 | 副作用 |
|---|---|---|
-ObjC | 強制鏈接器載入靜態庫中所有 Objective-C 類別與分類 | 略增大二進制體積 |
-all_load | 強制載入靜態庫中**所有**目標檔 (含純 C/C++ 代碼) | 體積增長更大,可能引入無用符號衝突 |
建議:優先只加 `-ObjC`,若類別方法仍丟失再加 `-all_load`。現代 Xcode (10+) 對 `-ObjC` 處理已較完善,單獨使用通常足夠。
Unbalanced calls to begin/end appearance transitions for <ViewController: 0x...>.
iOS 7 上 Push 新視圖控制器失敗,返回鍵點擊後出現黑屏。iOS 8+ 正常。
在 `viewDidLoad` 中發起網路請求,回調中直接 `pushViewController:`。此時**當前視圖控制器的轉場動畫尚未完成** (`viewDidAppear` 尚未調用),導致導航控制器棧內同時存在兩個進行中的轉場操作。
- (void)viewDidLoad {
[super viewDidLoad];
[API requestDataWithCompletion:^(id result) {
// 當前 VC 可能還在 push 動畫中!
[self.navigationController pushViewController:webVC animated:YES];
}];
}
- (void)viewDidAppear:(BOOL)animated {
[super viewDidAppear:animated];
// 確保當前 VC 完全顯示、動畫結束
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
[API requestDataWithCompletion:^(id result) {
// 主執行緒安全推薦
dispatch_async(dispatch_get_main_queue(), ^{
if (self.navigationController) { // 防止已被 pop
[self.navigationController pushViewController:webVC animated:YES];
}
});
}];
});
}
iOS 7 對轉場協調器 (`UIViewControllerTransitionCoordinator`) 管控更嚴格,不允許巢狀轉場。iOS 8+ 內部容錯性增強,但**不代表可以忽視規範**——後續版本可能收緊,且邏輯競態仍可能導致不可預期行為。