公司專案需要實現 rar 解壓功能。上網找資料時發現相關資源不多,不過有幾個人推薦名為 Unrar4iOS 的第三方開源框架。下載試用後發現它確實可用,但過程中遇到幾個問題,特此記錄,讓後來者少走彎路。
1. 不支援 armv7s。 編譯好的 framework 只包含 armv7 與 arm64,缺少 armv7s slice,因此在 iPhone 5/5C 這類裝置上會連結失敗。
2. framework 內的部分方法沒有實作。 例如:
- (BOOL)unrarFileTo:(NSString *)path overWrite:(BOOL)overwrite;
這個方法的實作內容是空的,什麼都沒做。原作者後來雖然更新了 Unrar4iOS.h 與 Unrar4iOS.mm 兩個檔案,但並未重新編譯 framework,所以問題依然存在。
3. 直接引用原始碼會與 framework 符號衝突。 有人會問:把更新後的 .h 與 .mm 直接拉進專案不就解決了?答案是:如果你的專案 Other Link Flags 沒有設為 -ObjC,可以這麼做;否則會報一堆標識符重複的錯誤。
原本想用最新原始碼重新編譯一個支援 armv7s 的 framework,但把原始碼拖進其他工程後報出各種編譯錯誤,由於時間壓力最後放棄了。
最終採用的是上面第三個問題的解法:主工程的 Other Link Flags 已經設了 -ObjC,這是無法迴避的事實,我不能為了整合這一個 framework 而改動主工程設定(牽涉面太大)。既然衝突來自重複符號,那就把重複的部分改名即可。
代價是必須放棄 armv7s 支援。以下記錄完整步驟。
https://github.com/ararog/Unrar4iOS
將解壓後 Unrar4iOS 目錄下的 RARExtractException 與 Unrar4iOS 的 .h/.m 檔,以及 Unrar4iOSExample → Frameworks → Unrar4iOS.framework,分別拖進你的專案並勾選 Copy:

若專案開啟了 ARC,會出現 autorelease 相關錯誤,刪除即可:

再次執行仍會報錯:

原因是 raros.hpp 與 dll.hpp 這兩個標頭檔被包含在 framework 內部,所以要改用尖括號 <> 的方式引入:

再次執行會發現更多 ARC 相關錯誤,把 release 等呼叫刪掉:

至此專案應該能在模擬器上編譯成功。
換成真機編譯,會出現前面提到的 armv7s 錯誤:

修改方式:把下圖第一個紅框內的 YES 改為 NO,並刪除第二個紅框內的 arm64 與 armv7s,只保留 armv7:

別忘了加入 libz.dylib:

查看專案設定的 Other Link Flags。如果沒有 -ObjC,那麼到這裡就完成了,模擬器與真機都能正常使用:

如果設了 -ObjC,你會看到標識符重複的錯誤,原因是我們拖進來的 Unrar4iOS.mm 與 framework 內的實作重複了:

解法是先把 Unrar4iOS.h 與 Unrar4iOS.mm 從專案中移除,修改完成後再加回來。我的做法是把這兩個檔改名為 KWUnrar4iOS.h 與 KWUnrar4iOS.mm,並把 KWUnrar4iOS.mm 中的兩個 CallbackProc 改為 CallbackProcc,完成後重新加入工程。最終結構如下:

真機編譯通過,所有步驟完成。
Demo:https://github.com/zzltjnh/Unrar4iOSDemo
必須誠實地說,上面這套做法本質上是「把所有問題都繞過去」,代價是放棄 armv7s、手動改原始碼、而且每次 framework 更新都要重做一遍。如果重來一次,我會優先評估這幾個方向:
改用 CocoaPods 整合 unrar 的 C++ 原始碼。 把 libunrar 的 C++ 源碼直接編進專案,而不是依賴預編譯的 framework。這樣能自動支援所有架構(包含 arm64 與模擬器),也不會有符號重複問題。網路上有現成的 Podspec 可用。
評估是否真的需要 rar。 iOS 對 zip 有原生的 NSFileManager/Compression Framework 支援,若後端能改為提供 zip,可省下大量麻煩。rar 是私有格式,在 iOS 上支援一向棘手。
注意目錄與檔案權限。 解壓大量檔案時應寫入 tmp 或 Caches 而非 Documents,否則會被 iCloud/iTunes 備份,也可能導致審核被退。
另外提醒:在現代專案中,armv7s 與 -ObjC 的設定早已不是問題(armv7s 已完全淘汰,最低支援為 arm64),因此本文的步驟主要作為維護舊專案時的參考。