iOS项目集成OpenCV及踩过的坑
一、直接下载Framework集成
1.1、下载OpenCV的Framework
从OpenCV官网下载框架,拖入Xcode项目。
1.2、导入OpenCV依赖的库
导入路径:选择项目—>Targets—>General—>Linked Frameworks and Libraies,点击”+”添加下方依赖库。
- libc++.tbd
- AVFoundation.framework
- CoreImage.framework
- CoreGraphics.framework
- QuartzCore.framework
- Accelerate.framework
- CoreVideo.framework
- CoreMedia.framework
- AssetsLibrary.framework
1.3、改为Objective-C与C++混编
凡是导入OpenCV头文件的类,都需要把相应类后缀名.m改为.mm。
#import <opencv2/opencv.hpp>
#import <opencv2/imgproc/types_c.h>
#import <opencv2/imgcodecs/ios.h>
复制代码
二、CocoaPods方式集成(不推荐)
2.1 CocoaPods文件配置
在项目Pod文件中配置pod ‘OpenCV’,然后pod update;同理,使用时导入OpenCV相应的头文件,并把类后缀名.m改为.mm。
2.2 使用CocoaPods集成OpenCV说明
使用CocoaPods虽然配置简单,但自动配置的不正确,存在名称重复等大量的问题。例如:
Warning: Multiple build commands for output file /Users/P85755/Library/Developer/Xcode/DerivedData/PracticeProject-bgmxispyljyrbfdimchwaxacraaa/Build/Products/Debug-iphoneos/OpenCV/calib3d.hpp Warning: Multiple build commands for output file /Users/P85755/Library/Developer/Xcode/DerivedData/PracticeProject-bgmxispyljyrbfdimchwaxacraaa/Build/Products/Debug-iphoneos/OpenCV/core.hpp 。。。。。。。。。等等 是由于CocoaPods自动配置时,生成了相同名称的.h配置文件,虽然在不同路径,Xcode仍旧认为是同一个文件。
三、已经踩过的深坑
3.1、导入头文件的深坑
导入**#import <opencv2/opencv.hpp>报Expected identitier的错误。这是由于opencv 的 import 要写在#import <UIKit/UIKit.h>、#import <Foundation/Foundation.h>**这些系统自带的 framework 前面
,否则会出现重命名的冲突。
3.2、Objective-C和C++的混编的深坑
OpenCV框架提供是C++的API接口,凡是使用OpenCV的地方,类的文件类型必须由.m类型改为.mm类型,这时候编译器按照OC与C++混编进行编译。
假设你使用OpenCV的类为A.mm,那如果你在Objective-C的类B.m中导入使用,此时编译器会认为此时A.mm也按照Objective-C类型编译,你必须把B.m类型更改为B.mm类型才不会报错,以此类推,你在C.m中使用B.mm,那C也必须更改为C.mm类型。。。有人比喻这样蔓延的有点像森林大火,一个接一个,很形象。
解决办法:
在导入OpenCV头文件的时候,#import <opencv2/opencv.hpp>前面加上#ifdef __cplusplus,指明编译器只有使用了OpenCV的.mm类型文件,才按照C++类型编译。如下即可解决:
#ifdef __cplusplus
#import <opencv2/opencv.hpp>
#import <opencv2/imgproc/types_c.h>
#import <opencv2/imgcodecs/ios.h>
#endif
复制代码
3.3、编译警告
导入OpenCV使用时,Xcode8会有一堆类似warning: empty paragraph passed to '@param' command [-Wdocumentation]
的文档警告。
虽然项目目前不报错了,但对于有强迫症的小伙伴来说,还是不能忍。解决办法:导入头文件的时候,忽略文档警告即可;同时只在需要的地方导入C++类,则加上编译器忽略文档警告即可,解决办法如下:
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wdocumentation"
#ifdef __cplusplus
#import <opencv2/opencv.hpp>
#import <opencv2/imgproc/types_c.h>
#import <opencv2/imgcodecs/ios.h>
#endif
#pragma clang pop
复制代码
3.4、UIImage与cv::Mat转换报错。
读取视频帧,转换为UIImage时报**_CMSampleBufferGetImageBuffer", referenced from:的错误,是由于缺少CoreMedia.framework框架,在Targets—>General—>Linked Frameworks and Libraies导入CoreMedia.framework**框架即可。
如果您觉得有所帮助,请在GitHub OpenCVDemo上赏个Star ⭐️,您的鼓励是我前进的动力