返回

FluttOS：在 MacOS 上集成 OpenCV dylib 时遇到的坑和解决方法

IOS

前言

在开发图像处理应用程序时，我需要借助 OpenCV 的强大功能来处理图像。因此，我将 OpenCV 编译成 dylib 并集成到我的 Flutter macOS 项目中。然而，在此过程中遇到了不少坑，现将其记录下来，供其他开发者参考。

踩坑 1：dylib 运行找不到

将 dylib 放置在 Flutter 项目的指定目录后，运行应用程序时却发现 dylib 找不到。经过一番排查，发现是由于 Flutter 默认在沙盒环境中运行，而 dylib 不在沙盒中，导致加载失败。

解决方案：

将 dylib 添加到 Flutter 的 Info.plist 文件中，以明确告知系统 dylib 的存在和位置。具体步骤如下：

  1. 在 Xcode 中打开 Flutter 项目。
  2. 在工程导航器中选择 Runner。
  3. 展开 Info.plist 文件。
  4. 添加一个名为 "LSApplicationLibraryData" 的键，并将 dylib 路径设置为值。

踩坑 2：符号未定义

在成功加载 dylib 后，又遇到了符号未定义的问题。这是因为 Flutter 项目默认使用 Objective-C 编译，而 OpenCV 是用 C++ 编写的。

解决方案：

修改 Flutter 项目的编译设置，使用 C++ 编译器。具体步骤如下：

  1. 在 Xcode 中打开 Flutter 项目。
  2. 在工程导航器中选择 Runner。
  3. 展开 Build Settings。
  4. 在 Architectures 下，将 Debug 和 Release 模式的 Valid Architectures 设置为 arm64。
  5. 在 Build Options 下，将 Debug 和 Release 模式的 Enable C++ Exceptions 设置为 YES。

踩坑 3：许可证协议

OpenCV 采用 BSD 许可证协议，需要在应用程序中包含版权声明。

解决方案：

在应用程序启动时，通过调用 OpenCV 的 cv::setLicenseKey 函数包含版权声明。具体代码如下：

cv::setLicenseKey(YOUR_LICENSE_KEY);

深入探究

除了解决上述踩坑外，我还深入探究了 OpenCV 和 Flutter 的集成机制。OpenCV 使用 C++ 编写，而 Flutter 使用 Dart 语言。为了在 Flutter 中使用 OpenCV，需要使用诸如 FFI 之类的工具构建桥梁。

FFI（外函数接口）

FFI 是一种允许 Dart 代码调用 C 代码的机制。它通过生成 Dart 与 C 代码之间的绑定代码来实现这一功能。在 Flutter 中，可以使用 FFI 包轻松调用 C 函数。

OpenCV FFI 库

社区已经创建了 OpenCV FFI 库，为 Dart 开发人员提供了与 OpenCV 函数交互的便利方法。该库封装了 OpenCV 的 C++ API，使其可以从 Dart 代码中轻松调用。

示例代码

以下是一个示例代码，演示了如何在 Flutter 中使用 OpenCV FFI 库加载图像并显示它：

import 'package:opencv/opencv.dart';

void main() {
  // 加载图像
  Mat image = imread('path/to/image.png');

  // 显示图像
  imshow('Image', image);
}

总结

在 Flutter 的 macOS 项目中集成 OpenCV dylib 并非易事，但通过解决上述踩坑，我成功完成了集成。深入理解 OpenCV 和 Flutter 的集成机制以及使用 FFI 和 OpenCV FFI 库，有助于顺利完成图像处理任务。希望这篇文章能为其他开发者提供参考和帮助。