把既有專案從 MRR(手動引用計數)遷移到 ARC,大致有兩條路:使用 Xcode 內建的轉換工具,或手動標記特定檔案。
ARC 是 LLVM 3.0 編譯器的特性,而老專案可能仍使用 GCC 4.2 或 LLVM-GCC,因此第一步是把編譯器換成新版 LLVM(在 Xcode 4.5 的時代,LLVM 3.0 已升級為 4.1)。
建議同時做兩件事:
接著把 Objective-C Automatic Reference Counting 設為 YES。這個選項轉換工具會自動幫你打勾,但了解手動設定的位置並沒有壞處。
然後執行 Edit > Refactor > Convert to Objective-C ARC。Xcode 會開一個新視窗讓你勾選要轉換的檔案;按下 Check 後,若有阻礙轉換的錯誤會逐一提示。
若沒有警告與錯誤,Xcode 會顯示轉換預覽:左側是修改後的內容,右側是原始檔案,你可以逐檔確認改動是否正確,最後按 Save 完成。
轉換完成後,Xcode 會移除所有 retain、release、autorelease 呼叫。這一步可能引發新的警告或語法問題(例如 dealloc 中殘留的 [super dealloc]),需要手動收尾。
一個重要提醒:自動轉換工具最好只用一次。若第一次沒有轉完所有檔案,之後再想轉剩下的檔案時,Xcode 很可能什麼都不做。因此一次轉乾淨,剩下的手動處理反而更省事。
在 Build Phases 的 Compile Sources 列表中,找到目標 .m 檔,於 Compiler Flags 欄加上:
-fobjc-arc
這代表該檔案以 ARC 規則編譯。這正是「專案整體關閉 ARC、單一檔案使用 ARC」或反之的混合做法。
同理,加上:
-fno-objc-arc
代表該檔案維持手動管理。實務上常見的情境是引入不支援 ARC 的第三方庫,或某段程式碼需要精確控制 release 時機(例如與 C/C++ 或使用 CF 系列 API 高度耦合的模組)。以檔案為粒度切換,比整個專案一起遷移務實得多。