OpenSceneGraph集成到应用hap

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

开发环境

编译三方库

  • 下载本仓库

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

    tpc_c_cplusplus/thirdparty/OpenSceneGraph  #三方库OpenSceneGraph的目录结构如下
    ├── docs                              #三方库相关文档的文件夹
    ├── HPKBUILD                          #构建脚本
    ├── HPKCHECK                          #测试脚本
    ├── SHA512SUM                         #三方库校验文件
    ├── README.OpenSource                 #说明三方库源码的下载地址,版本,license等信息
    ├── README_zh.md                      #三方库简介
    ├── osg_test.patch                    #用于OpenSceneGraph库编译的补丁
    
  • 在lycium目录下编译三方库

    编译环境的搭建参考准备三方库构建环境

    cd lycium
    ./build.sh OpenSceneGraph
    
  • 三方库头文件及生成的库

    在lycium目录下会生成usr目录,该目录下存在已编译完成的32位和64位三方库

    OpenSceneGraph/arm64-v8a   OpenSceneGraph/armeabi-v7a
    
  • 测试三方库

应用中使用三方库

  • 在IDE的cpp目录下新增thirdparty目录,将编译生成的头文件和库文件拷贝到该目录下,如下图所示:

     thirdparty_install_dir

  • 在最外层(cpp目录下)CMakeLists.txt中添加如下语句

    #将三方库的头文件加入工程中
    target_include_directories(OpenSceneGraph PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/include) 
    #将三方库加入工程中 
    target_link_libraries(OpenSceneGraph PRIVATE 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libOpenThreads.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosg.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgAnimation.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgDB.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgFX.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgGA.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgManipulator.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgParticle.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgPresentation.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgShadow.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgSim.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgTerrain.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgText.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgUI.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgUtil.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgViewer.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgVolume.so.3.6.5 
        ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/OpenSceneGraph/${OHOS_ARCH}/lib/libosgWidget.so.3.6.5 
    )
    

测试三方库

进入到构建目录运行测试用例(注意arm64-v8a为构建64位的目录,armeabi-v7a为构建32位的目录),执行结果如图所示

# 进入对应架构的构建目录
cd OpenSceneGraph-OpenSceneGraph-3.6.5/armeabi-v7a-build/bin

# 设置动态链接库路径
export LD_LIBRARY_PATH=../lib:$LD_LIBRARY_PATH

# 运行所有测试模块
./osgunittests matrix && \
./osgunittests sizeof && \
./osgunittests quat && \
./osgunittests performance && \
./osgunittests "read-threads 4" && \
./osgunittests filenames && \
./osgunittests thread && \
./osgunittests polytope && \
./osgunittests qt && \
./osgunittests "quat_scaled 1.0 1.0 1.0"

 ![openscenegraph_test](pic/openscenegraph_test.png)

## 参考资料

- [润和RK3568开发板标准系统快速上手](https://gitee.com/openharmony-sig/knowledge_demo_temp/tree/master/docs/rk3568_helloworld)
- [OpenHarmony三方库地址](https://gitee.com/openharmony-tpc)
- [OpenHarmony知识体系](https://gitee.com/openharmony-sig/knowledge)
- [OpenSceneGraph官方文档](https://openscenegraph.org/documentation/)