Skip to content

Latest commit

 

History

History
136 lines (100 loc) · 5.9 KB

BUILD.md

File metadata and controls

136 lines (100 loc) · 5.9 KB
Raw

编译说明

依赖的第三方库下载

  1. 下载opencv，下载地址
  • OpenCV静态库：opencv-(版本号)-平台.7z，
  • 把压缩包解压到项目根目录，windows平台需要注意目录层次，解压后目录结构如下
  • windows平台分为mt和md版，mt代表静态链接CRT，md代表动态链接CRT
OcrLiteNcnn/opencv-static
├── OpenCVWrapperConfig.cmake
├── linux
├── macos
├── windows-x64
└── windows-x86
  1. 下载onnxruntime，下载地址
  • 如果因系统太新或太旧而不支持，请尝试自己折腾编译。
  • ncnn静态库：ncnn-(版本号)-平台.7z，
  • ncnn gpu静态库：ncnn-(版本号)-平台-vulkan.7z，
  • windows平台分为mt和md版，mt代表静态链接CRT，md代表动态链接CRT
  • cpu版解压放入RapidOcrNcnn/ncnn-static
RapidOcrNcnn/ncnn-static
├── NcnnWrapperConfig.cmake
├── linux
├── macos
├── windows-x64
└── windows-x86
  • gpu版解压放入RapidOcrNcnn/ncnn-vulkan-static
RapidOcrNcnn/ncnn-vulkan-static
├── NcnnWrapperConfig.cmake
├── linux
├── macos
├── windows-x64
└── windows-x86

依赖库vulkan SDK下载

Vulkan SDK下载地址

  • 如果想编译ncnn gpu，则必须先安装Vulkan SDK。
  • 一般下载最新版即可，当前最新版1.3.236.0，安装时选中所有组件。
  • Windows：直接双击安装。
  • macOS：加载dmg后，直接双击安装。
  • Linux: 解压tar.gz文件到某个路径，并配置export VULKAN_SDK=解压路径/1.3.236.0/x86_64, export PATH=解压路径/1.3.236.0/x86_64/bin:$PATH

编译环境

  1. Windows 10 x64
  2. macOS 10.15
  3. Linux Ubuntu 1804 x64

注意：以下说明仅适用于本机编译。如果需要交叉编译为arm等其它平台(参考android)，则需要先交叉编译所有第三方依赖库(ncnn、opencv)，然后再把依赖库整合替换到本项目里。

Windows编译说明

Windows nmake编译

  1. 安装VS2019，安装时，至少选中'使用C++的桌面开发'
  2. cmake>=3.12请自行下载&配置，下载地址
  3. 开始菜单打开"x64 Native Tools Command Prompt for VS 2019"或"适用于 VS2017 的 x64 本机工具"，并转到本项目根目录
  4. 运行build.bat并按照提示输入选项，最后选择'BIN可执行文件'
  5. 编译完成后运行run-test.bat进行测试(注意修改脚本内的目标图片路径)
  6. 编译JNI动态运行库(可选，可用于java调用)
  • 下载jdk-8u221-windows-x64.exe，安装选项默认(确保“源代码”项选中)，安装完成后，打开“系统”属性->高级->环境变量
  • 新建“系统变量”，变量名JAVA_HOME ，变量值```C:\Program Files\Java\jdk1.8.0_221``
  • 新建“系统变量”，变量名CLASSPATH ，变量值```.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;``
  • 编辑“系统变量”Path，Win7在变量值头部添加%JAVA_HOME%\bin; ，win10直接添加一行%JAVA_HOME%\bin
  • 开始菜单打开"x64 Native Tools Command Prompt for VS 2019"或"适用于 VS2017 的 x64 本机工具"，并转到本项目根目录
  • 运行build.bat并按照提示输入选项，最后选择'JNI动态库'

Windows Visual Studio编译说明

  1. VS2019，cmake……等安装配置参考上述步骤。
  2. 运行generate-vs-project.bat，输入数字选择要生成的visual studio项目解决方案版本。
  3. 根据你的编译环境，进入build-xxxx-x86或x64文件夹，打开RapidOcrNcnn.sln。
  4. 在顶部工具栏选择Release，在右边的"解决方案"窗口，右键选中"ALL_BUILD"->生成。要选择Debug，则您必须自行编译Debug版的opencv和ncnn。

Windows部署说明

  1. 如果有依赖的库是动态库时，部署的时候记得把dll复制到可执行文件目录。
  2. 部署时如果提示缺少"VCRUNTIME140_1.dll"，下载安装适用于 Visual Studio 2015、2017 和 2019 的 Microsoft Visual C++ 可再发行软件包， 下载地址

macOS编译说明

  1. macOS Catalina 10.15.x，安装Xcode>=12，并安装Xcode Command Line Tools, 终端运行xcode-select –install
  2. 自行下载安装HomeBrew，cmake >=3.19下载地址
  3. libomp: brew install libomp
  4. 终端打开项目根目录，./build.sh并按照提示输入选项，最后选择'BIN可执行文件'
  5. 测试：./run-test.sh(注意修改脚本内的目标图片路径)
  6. 编译JNI动态运行库(可选，可用于java调用)
  • 下载jdk-8u221-macosx-x64.dmg，安装。
  • 编辑用户目录下的隐藏文件.zshrc ，添加export JAVA_HOME=$(/usr/libexec/java_home)
  • 运行build.sh并按照提示输入选项，最后选择'JNI动态库'

macOS部署说明

如果有依赖的库是动态库时，参考下列方法：

  • 把动态库所在路径加入DYLD_LIBRARY_PATH搜索路径
  • 把动态库复制或链接到到/usr/lib

Linux编译说明

  1. Ubuntu18.04 LTS 其它发行版(请自行编译依赖库opencv和ncnn，或自行适配官方发布的动态库)
  2. sudo apt-get install build-essential
  3. cmake>=3.17下载地址
  4. 终端打开项目根目录，./build.sh并按照提示输入选项，最后选择'BIN可执行文件'
  5. 测试：./run-test.sh(注意修改脚本内的目标图片路径)
  6. 编译JNI动态运行库(可选，可用于java调用)
  • 下载jdk-8u221并安装配置
  • 运行build.sh并按照提示输入选项，最后选择'JNI动态库'
  • 注意：编译JNI时，g++版本要求>=6

Linux部署说明

有依赖的库是动态库时，参考下列方法：

  • 把动态库所在路径加入LD_LIBRARY_PATH搜索路径
  • 把动态库复制或链接到到/usr/lib