BoofCV

环境要求

• Java 11 或更高版本（任意免费发行版均可，如 Zulu）
• Git，且需支持 --recursive 子模块拉取
• 无需预先安装 Gradle，仓库自带 gradlew 脚本
• 需联网，Gradle 会自动下载所需依赖

安装与启动步骤

1. 1克隆仓库

   使用 --recursive 参数克隆 SNAPSHOT 分支源码，否则子模块数据目录会为空。

   git clone -b SNAPSHOT --recursive https://github.com/lessthanoptimal/BoofCV.git boofcv

   复制

2. 2补全子模块

   若克隆时漏掉 --recursive 导致数据目录为空，进入目录后手动初始化子模块。

   cd boofcv
   git submodule update --init --recursive

   复制

3. 3清理旧代码

   删除 main 目录下过期的自动生成代码，避免构建时使用陈旧文件。

   cd boofcv
   git clean -fd main

   复制

4. 4生成代码

   用 Gradle 脚本自动生成所需的源码，首次运行会下载构建依赖。

   ./gradlew autogenerate

   复制

5. 5运行示例

   打包 examples 并运行，示例代码位于 boofcv/examples，适合首先阅读。

   ./gradlew examplesJar
   java -jar examples/examples.jar

   复制

6. 6运行演示

   打包 demonstrations 并运行，可查看可视化演示程序。

   ./gradlew demonstrationsJar
   java -jar demonstrations/demonstrations.jar

   复制

如何确认成功

执行 java -jar examples/examples.jar 后无报错并出现示例程序界面，即表示构建与运行成功。

常见问题

注意事项

• 全部算法均以纯 Java 实现，不依赖 OpenCV 原生库，可直接打包进桌面应用或 APK。
• 示例代码在 boofcv/examples，演示代码在 boofcv/demonstrations，建议先阅读示例代码。
• 构建与运行前请确认已安装 Java 11 或更高版本。
• 添加为 Gradle/Maven 依赖的方式见 README 的 “Adding to Gradle and Maven Projects” 章节。