本條整理日常 iOS 開發中經常遇到的 Xcode 報錯與對應解法,方便快速排錯。
手動管理記憶體(MRC)的專案引入採用 ARC 編寫的第三方庫時,常會遇到:@synthesize of 'weak' property is only allowed in ARC or GC mode。這是因為 ARC 用到的 weak 等修飾符在 MRC 中無法編譯。
直接把 weak 改成 assign 雖可暫解,但可能導致閃退、崩潰。較好的做法是:在 Build Phases → Compile Sources 中,雙擊出問題的檔案,加入 -fobjc-arc;反之,在 ARC 專案中引入 MRC 檔案,則加入 -fno-objc-arc。
通常是申請的 key 安全碼與程式碼中的 bundle id 不一致,改成一致即可。
定位需持續進行,若封裝所在的類別未設為 static 靜態變量,物件會被釋放,導致後續不再定位。
這類問題多半是程式碼寫錯所致。常見原因是 Info.plist 中對應變量的 Type 應為 String 而非 Boolean,蘋果以字串比對判斷,型別錯誤便會崩潰。
需在「被擴展的類」的 .m 檔中導入你的類目標頭檔;此外,類目中不能宣告變量。
資料源陣列建議採懶加載,並記得在適當時機賦 nil,避免空值問題。
通常是監聽了錯誤的通知,應監聽「鍵盤即將顯示」的通知,而非「已顯示」的通知。
_configureCellForDisplay:forIndexPath:原因是 cellForRowAtIndexPath: 回傳了 nil,需確保每個 indexPath 都回傳有效的 cell。
多為 .xcodeproj 檔案在版本控制合併時產生衝突。解法:
<<<<<<<、=======、>>>>>>> 等衝突標記行。導入 libxml2.dylib,並將 Header Search Paths 設為 /usr/include/libxml2。
缺少庫所致,加入 libresolv.dylib 即可。此外,離開使用上拉下拉刷新的介面時要記得釋放刷新類;不要在 viewDidLoad 中跳轉控制器。
報 Assertion failure in -[AFHTTPRequestSerializer ...],需對 URL 做編碼:
urlString = [urlString stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
如 Receiver type 'XXX' for instance message is a forward declaration。ARC 要求完整的前向引用,若在子類中呼叫父類未覆蓋的方法,必須 #import 父類的 .h,否則無法編譯。
發布時若把 scheme 的 Build Configuration 改成了 Release,對應的是發布證書,真機除錯就會失敗,改回 Debug 即可。
iOS 9 起預設要求 HTTPS,若專案仍使用 HTTP 會報:The resource could not be loaded because the App Transport Security policy requires the use of a secure connection。暫時解法是在 Info.plist 加入:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>

長遠來看,私有加密並非萬全之策,及早改用 HTTPS 才能確保傳輸安全。
使用 xcode-select 切換即可:
sudo xcode-select --switch /Applications/Xcode-beta.app/
注意路徑是硬碟下的 Applications,而非使用者目錄下的,並盡量讓系統提示完整路徑以免出錯。
如 Couldn't materialize: couldn't get the value of variable。表現為一行程式執行後物件立刻變空,但通常不影響實際使用。

Can't merge models with two different entities named 'MessageModel'。多因工程內自動產生了 .xcdatamodeld 檔,將其刪除、Clean,再把 App 從裝置移除後重新運行即可。
檢查:代理是否掛上、行數或段數是否被設為 0、tableView 的 frame 是否為 0。
通常是誤刪了 Apple Worldwide Developer Relations Certification Authority(iPhone Developer 憑證的簽發者)。解法是從 Apple 官網重新下載並拖入鑰匙串登入目錄。
先別急著懷疑憑證,應檢查 target 與 test target 是否設定了相同的 provisioning 設定檔。
Xcode 自動維護憑證時偶爾不會自動加入新裝置。解法: