iOS 開發：OpenCV.framework 到底是什麼？如何正確集成

概念釐清

.framework 是 iOS/macOS 上的動態庫打包格式，包含：

• 編譯後的二進制碼（OpenCV）
• 公開頭文件（Headers/）
• 資源文件（如模型數據）
• 模塊映射（Modules/module.modulemap）供 Swift/ObjC 混編

簡單說：你下載的 OpenCV iOS 包裡的 opencv2.framework 就是所需的全部。

集成步驟

1. 下載：官網 OpenCV Releases 選擇 opencv-4.x.x-ios-framework.zip。
2. 拖入專案：將 opencv2.framework 拖到 Xcode 專案導航欄，勾選 Copy items if needed、Create groups、目標 Target。
3. 配置 Build Settings：
   • Framework Search Paths 加入 $(PROJECT_DIR)（若非自動）。
   • Enable Bitcode 設為 NO（OpenCV 官方框架暫不支援 Bitcode）。
4. 引入頭文件：

   // Objective-C
   #import <opencv2/opencv.hpp>
   // Swift 需橋接頭文件
   #import <opencv2/opencv.hpp>

5. 源文件改名：使用 C++ API 的 .m 文件需改為 .mm（Objective-C++）。

常見坑點

驗證集成

cv::Mat img = cv::imread([[NSBundle mainBundle] pathForResource:@"test" ofType:@"jpg"]);
NSLog(@"Image size: %dx%d", img.cols, img.rows); // 輸出尺寸即成功

總結

OpenCV.framework 就是 OpenCV 庫的標準 iOS 發布形式，直接拖入、配置路徑、改 .mm、關 Bitcode 四步走，即可在 iOS 專案中享受完整的計算機視覺能力。