如何将三方库集成到hap包中——通过IDE集成非cmake方式构建的C/C++三方库

码中之牛2024-04-14 16:14

简介

DevEco Studio(简称IDE)目前只支持cmake构建方式，对于非cmake构建方式的三方库需要通过IDE工具集成的话，我们需要对原生库编写一个cmake的构建脚本。本文通过tinyxpath三方库为例介绍如何在IDE上移植一个非cmake构建方式的三方库。

cmake构建脚本编写

在IDE上移植一个非cmake构建方式的三方库，我们需要了解基本的cmake构建脚本的编写

TinyxPath三方库移植

原生库的准备

原生库下载

本文中是用tinyxpath 1.3.1版本，可以通过以下方式进行下载:

shell 复制代码 
wget https://sourceforge.net/projects/tinyxpath/files/TinyXPath%20%28Linux%20-%20tar.gz%29/TinyXPath%201.3.1/tinyxpath_1_3_1.tgz

下载完后进行解压:

shell 复制代码 
tar -zxvf tinyxpath_1_3_1.tgz -C tinyxpath1.3.1 # 将tinyxpath_1_3_1.tgz解压到tinyxpath1.3.1, tinyxpath1.3.1文件夹必须存在
源码分析

  • 依赖分析

    tinyxpath是configure构建方式，根据官网提示生成对应configure命令并执行configure：

    shell 复制代码 
    make -f Makefile.configure
./configure

通过configure的输出日志可以分析出，tinyxpath库不依赖其他任何三方库。

  • 源文件分析

    1. 生成库和测试用例的源文件分析

      我们通过分析Makefile，查找对应目标依赖的原文件如，tinyxpath库的Makefile文件中的目标源文件定义

从以上内容可以看出，编译此库目标依赖的上面的所有.cpp文件。tinyxpath库比较特殊，在linux下面没有生成库文件，生成了一个可执行文件，通过tinyxpath官网介绍可知道，main.cpp和htmlutil.cpp是用于生成测试用例，其他文件是用来生成库文件。

除了分析Makefile文件，我们也可以通过分析make过程的输出信息来分析.

通过以上分析可以得出，tinyxpath库目标依赖的源文件是：

shell 复制代码 
    action_store.cpp  lex_util.cpp  node_set.cpp  tinyxml.cpp tinyxmlparser.cpp  xml_util.cpp xpath_processor.cpp  xpath_static.cpp  xpath_syntax.cpp tinystr.cpp tinyxmlerror.cpp  tokenlist.cpp xpath_expression.cpp  xpath_stack.cpp xpath_stream.cpp

测试用例依赖的源文件是：

shell 复制代码 
    main.cpp htmlutil.cpp

  1. 特殊变量分析

    通过交叉编译原生库可从编译过程中获取一些我们需要的变量或者宏的设定。如若交叉编译过程中缺少变量/宏的定义会导致编译失败，我们需要在cmake构建脚本中添加对应的变量/宏。

通过以上方法可以分析出，tinyxpath库中未涉及特殊变量或者宏定义

新建cmake构建脚本

分析完tinyxpath的源码后，我们就可以根据cmake构建脚本编写的方法编写tinyxpath的cmake构建脚本了。

  1. 基本信息的编写

设置tinyxpath cmake构建的工具版本，工程名及工程版本以和构建语言

cmake 复制代码 
   cmake_minimum_required (VERSION 3.12)

   project(TINYXPATH VERSION 1.3.1)
   enable_language(CXX C ASM)
  1. 设置常用变量
cmake 复制代码 
   set(BUILD_SHARED_LIBS TRUE CACHE BOOL "If TRUE, tinyxpath is built as a shared library, otherwise as a static library")

   set(TARGET_NAME tinyxpath)
   set(TARGET_SAMPLE_NAME tinyxpath_test)

   set(TARGET_INSTALL_INCLUDEDIR include)
   set(TARGET_INSTALL_BINDIR bin)
   set(TARGET_INSTALL_LIBDIR lib)

   set(TARGET_SRC_PATH ${CMAKE_CURRENT_SOURCE_DIR}/tinyxpath1.3.1)
   set(TARGET_SRC ${TARGET_SRC_PATH}/tinystr.cpp
                    ${TARGET_SRC_PATH}/tinyxml.cpp
                    ${TARGET_SRC_PATH}/tinyxmlerror.cpp
                    ${TARGET_SRC_PATH}/tinyxmlparser.cpp
                    ${TARGET_SRC_PATH}/action_store.cpp
                    ${TARGET_SRC_PATH}/lex_util.cpp
                    ${TARGET_SRC_PATH}/node_set.cpp
                    ${TARGET_SRC_PATH}/tokenlist.cpp
                    ${TARGET_SRC_PATH}/xml_util.cpp
                    ${TARGET_SRC_PATH}/xpath_expression.cpp
                    ${TARGET_SRC_PATH}/xpath_processor.cpp
                    ${TARGET_SRC_PATH}/xpath_stack.cpp
                    ${TARGET_SRC_PATH}/xpath_stream.cpp
                    ${TARGET_SRC_PATH}/xpath_syntax.cpp
                    ${TARGET_SRC_PATH}/xpath_static.cpp)
   
   set(TARGET_INCLUDE ${TARGET_SRC_PATH})

  1. 设置可选项

    测试用例做为一个三方库的可选项供用户自行选择是否编译，默认情况下是不编译测试用例

cmake 复制代码 
   option(BUILD_SAMPLE "Build sample" OFF)

   if(BUILD_SAMPLE)
      add_executable(${TARGET_SAMPLE_NAME} ${TARGET_SAMPLE_SRC})
      target_include_directories(${TARGET_SAMPLE_NAME} PRIVATE ${TARGET_INCLUDE})
      target_link_libraries(${TARGET_SAMPLE_NAME} PUBLIC ${TARGET_NAME})
   endif()
  1. 配置库以及其属性
cmake 复制代码 
   add_library(${TARGET_NAME} ${TARGET_SRC})
   target_include_directories(${TARGET_NAME} PRIVATE ${TARGET_INCLUDE})

   if(BUILD_SHARED_LIBS)
      set_target_properties(${TARGET_NAME} PROPERTIES VERSION ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.${PROJECT_VERSION_PATCH} 
                                                    SOVERSION ${PROJECT_VERSION_MAJOR})
   endif()
  1. 配置库的安装
cmake 复制代码 
   install(TARGETS ${TARGET_NAME}
        EXPORT ${TARGET_NAME}
        PUBLIC_HEADER DESTINATION ${TARGET_INSTALL_INCLUDEDIR}
        PRIVATE_HEADER DESTINATION ${TARGET_INSTALL_INCLUDEDIR}
        RUNTIME DESTINATION ${TARGET_INSTALL_BINDIR}
        LIBRARY DESTINATION ${TARGET_INSTALL_LIBDIR}
        ARCHIVE DESTINATION ${TARGET_INSTALL_LIBDIR})
   
   install(FILES ${TARGET_SRC_PATH}/xpath_processor.h
            ${TARGET_SRC_PATH}/action_store.h
            ${TARGET_SRC_PATH}/byte_stream.h
            ${TARGET_SRC_PATH}/lex_token.h
            ${TARGET_SRC_PATH}/lex_util.h
            ${TARGET_SRC_PATH}/node_set.h
            ${TARGET_SRC_PATH}/tinystr.h
            ${TARGET_SRC_PATH}/tinyxml.h
            ${TARGET_SRC_PATH}/tinyxpath_conf.h
            ${TARGET_SRC_PATH}/tokenlist.h
            ${TARGET_SRC_PATH}/xml_util.h
            ${TARGET_SRC_PATH}/xpath_expression.h
            ${TARGET_SRC_PATH}/xpath_processor.h
            ${TARGET_SRC_PATH}/xpath_stack.h
            ${TARGET_SRC_PATH}/xpath_static.h
            ${TARGET_SRC_PATH}/xpath_stream.h
            ${TARGET_SRC_PATH}/xpath_syntax.h
        DESTINATION ${TARGET_INSTALL_INCLUDEDIR}/${TARGET_NAME})
   
   install(
      EXPORT ${TARGET_NAME}
      FILE ${TARGET_NAME}Targets.cmake
      DESTINATION ${TARGET_INSTALL_LIBDIR}/cmake/${TARGET_NAME}
   )

   include(CMakePackageConfigHelpers)

   write_basic_package_version_file(
      ${TARGET_NAME}ConfigVersion.cmake
      VERSION ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.${PROJECT_VERSION_PATCH}
      COMPATIBILITY SameMajorVersion
   )

   configure_package_config_file(
      cmake/PackageConfig.cmake.in ${TARGET_NAME}Config.cmake
      INSTALL_DESTINATION ${TARGET_INSTALL_LIBDIR}/cmake/${TARGET_NAME}
   )

   install(FILES
            ${CMAKE_CURRENT_BINARY_DIR}/${TARGET_NAME}Config.cmake
            ${CMAKE_CURRENT_BINARY_DIR}/${TARGET_NAME}ConfigVersion.cmake
        DESTINATION
            ${TARGET_INSTALL_LIBDIR}/cmake/${TARGET_NAME}
   )

至此，tinyxpath的cmake构建脚本基本完成，具体可参照完整脚本

加入编译构建

将tinyxpath源码及新建的cmake构建脚本放置IDE工程对应的cpp目录下，并在顶层CMakeLists.txt文本中添加

cmake 复制代码 
add_subdirectory(tinyxpath)
target_link_libraries(entry PUBLIC libace_napi.z.so tinyxpath)

为了能让大家更好的学习鸿蒙（HarmonyOS NEXT）开发技术，这边特意整理了《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://qr21.cn/FV7h05

《鸿蒙开发学习手册》：

如何快速入门：https://qr21.cn/FV7h05

  1. 基本概念
  2. 构建第一个ArkTS应用
  3. ......

开发基础知识：https://qr21.cn/FV7h05

  1. 应用基础知识
  2. 配置文件
  3. 应用数据管理
  4. 应用安全管理
  5. 应用隐私保护
  6. 三方应用调用管控机制
  7. 资源分类与访问
  8. 学习ArkTS语言
  9. ......

基于ArkTS 开发：https://qr21.cn/FV7h05

  1. Ability开发
  2. UI开发
  3. 公共事件与通知
  4. 窗口管理
  5. 媒体
  6. 安全
  7. 网络与链接
  8. 电话服务
  9. 数据管理
  10. 后台任务(Background Task)管理
  11. 设备管理
  12. 设备使用信息统计
  13. DFX
  14. 国际化开发
  15. 折叠屏系列
  16. ......

鸿蒙开发面试真题（含参考答案）：https://qr18.cn/F781PH

鸿蒙开发面试大盘集篇（共计319页）：https://qr18.cn/F781PH

1.项目开发必备面试题

2.性能优化方向

3.架构方向

4.鸿蒙开发系统底层方向

5.鸿蒙音视频开发方向

6.鸿蒙车载开发方向

7.鸿蒙南向开发方向

相关推荐
敢嗣先锋2 分钟前
鸿蒙5.0实战案例：基于ArkUI的验证码实现
移动开发·harmonyos·openharmony·arkui·鸿蒙开发
JANGHIGH25 分钟前
c++ std::list使用笔记
c++·笔记·list
画个逗号给明天"32 分钟前
C++STL容器之list
开发语言·c++
鱼嘻1 小时前
Linux自学day23-进程和线程
linux·服务器·c语言·进程和线程
BUG 劝退师2 小时前
C语言预处理学习笔记
c语言·笔记·学习
Lqingyyyy2 小时前
P2865 [USACO06NOV] Roadblocks G 与最短路的路径可重复的严格次短路
开发语言·c++·算法
C语言小火车2 小时前
深入解析C++26 Execution Domain：设计原理与实战应用
java·开发语言·c++·异构计算调度·c++26执行模型·domain定制
小立爱学习3 小时前
Linux 内核自旋锁spinlock（四）--- queued spinlock
linux·c语言
别说我什么都不会3 小时前
鸿蒙轻内核M核源码分析系列十二 事件Event
操作系统·harmonyos
ox00803 小时前
C++ 设计模式-中介者模式
c++·设计模式·中介者模式
热门推荐
01太炸裂了！清华大学deepseek从入门到精通使用手册又出第三版了，《普通人如何抓住DeepSeek红利》（无套路，直接下载）02如何在WPS和Word/Excel中直接使用DeepSeek功能03DeepSeek本地部署详细指南04DeepSeek各版本说明与优缺点分析05本地部署DeepSeek教程（Mac版本）06DeepSeek r1本地安装全指南07本地化部署AI知识库：基于Ollama+DeepSeek+AnythingLLM保姆级教程08DeepSeek R1本地化部署 Ollama + Chatbox 打造最强 AI 工具09在Windows下安装Ollama并体验DeepSeek r1大模型10Page Assist - 本地Deepseek模型 Web UI 的安装和使用