leptonica集成到应用hap

本库是在RK3568开发板上基于OpenHarmony3.2 Release版本的镜像验证的,如果是从未使用过RK3568,可以先查看润和RK3568开发板标准系统快速上手

开发环境

编译三方库

  • 下载本仓库

    git clone https://gitee.com/openharmony-sig/tpc_c_cplusplus.git --depth=1
    
  • 三方库目录结构

    tpc_c_cplusplus/thirdparty/leptonica     #三方库leptonica的目录结构如下
    ├── adapted                              #存放三方库适配需要的代码文件
    ├── BUILD.gn                             # 构建脚本,支持rom包集成
    ├── docs                                 #三方库相关文档的文件夹
    ├── bundle.json                          #三方库组件定义文件
    ├── HPKBUILD                             #构建脚本
    ├── SHA512SUM                            #三方库校验文件
    ├── README.OpenSource                    #说明三方库源码的下载地址,版本,license等信息
    ├── README_zh.md      
    
  • 在lycium目录下编译三方库 编译环境的搭建参考准备三方库构建环境

    cd lycium
    ./build.sh leptonica zlib libpng libjpeg-turbo libwebp tiff giflib openjpeg zstd xz libdeflate
    
  • 三方库头文件及生成的库 在lycium目录下会生成usr目录,该目录下存在已编译完成的32位和64位三方库

    leptonica/arm64-v8a    leptonica/armeabi-v7a             zlib/arm64-v8a          zlib/armeabi-v7a   
    libpngc/arm64-v8a      libpng/armeabi-v7a                libjpeg-turbo/arm64-v8a libjpeg-turbo/armeabi-v7a 
    libwebp/arm64-v8a      libwebp/armeabi-v7a               tiff/arm64-v8a          tiff/armeabi-v7a 
    giflib/arm64-v8a       giflib/armeabi-v7a                openjpeg/arm64-v8a      openjpeg/armeabi-v7a 
    zstd/arm64-v8a         zstd/armeabi-v7a                  xz/arm64-v8a            xz/armeabi-v7a 
    libdeflate/arm64-v8a   libdeflate/armeabi-v7a       
    
  • 测试三方库

应用中使用三方库

  • 在IDE的cpp目录下新增thirdparty目录,将编译生成的头文件拷贝到该目录下,将编译生成的三方库以及依赖库全部(动态库名字带版本号和不带版本号的都需要)拷贝到工程的libs目录下,如下图所示:  leptonica_install
  • 在最外层(cpp目录下)CMakeLists.txt中添加如下语句
    #将三方库加入工程中
    target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/../../../libs/${OHOS_ARCH}/libleptonica.so)
    #将三方库的头文件加入工程中
    target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/leptonica/${OHOS_ARCH}/include)
    

测试三方库

三方库的测试使用原库自带的测试用例来做测试,准备三方库测试环境

进入到构建目录执行 make -C prog check-TESTS 运行测试用例,如下截图(arm64-v8a-build为构建64位的目录,armeabi-v7a-build为构建32位的目录)

leptonica_test

参考资料