您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 使用技巧 >> iOS 技巧大全

Unrar4iOS 整合踩坑記:armv7s 缺失與 -ObjC 的重複符號衝突

編輯:iOS 技巧大全

公司專案需要實現 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 相關錯誤

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

再次執行仍會報錯:

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

第四步:清掉剩下的 ARC 問題

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

至此專案應該能在模擬器上編譯成功。

第五步:真機編譯的 armv7s 錯誤

換成真機編譯,會出現前面提到的 armv7s 錯誤:

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

第六步:補上 libz.dylib

別忘了加入 libz.dylib:

第七步:檢查 Other Link Flags

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

第八步:解決 -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),因此本文的步驟主要作為維護舊專案時的參考。

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